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PREFACE 


This publication provides the reader with instructions and guidance in 
writing application programs for the IBM 2260 Display Station (Local 
Attachment) to run under OS/VS, uSing GAM — Graphic Programming Services 
(GPS). The macro instructions and control program routines which 
constitute GPS, are described in detail. Coding examples with 
accompanying explanations are included to illustrate uses of the macro 
instructions. 


To take full advantage of the operating system and the programming 
services provided for the 2260 display station, the reader should have 
completed a basic course in assembler language coding or have equivalent 
knowledge. He should also be familiar with the contents of the 
following publications: 


e IBM System/360 Component Description: IBM 2260 Display Station: 
IBM 2848 Display Control, GA27-—2700 


e IBM System/370 System Summary, GA22-—-7001 
® OS/VS_anag DOS/VS Assembler Language, GC33—4010 


e OS/VS1 Supervisor Services and Macro Instructions, GC24—5103 


e OS/VS2_ Supervisor Services and Marco Instructions, GC2e8-0683 


ee 


° OS/VS1 JCL Reference, GC24—5099 
® OS/VS2_ JCL Reference, GC28—0692 
® OS/VS_ Linkage Editor and Loader, GC26—3813 
For information to help determine and solve problems that involve 
display programs that use graphic programming services (GPS) for the 


2260 display station, see: 


° OS/VS_ Problem Determination Aids and Messages and Codes for GPS _ and 
GSP, GC27—6974 
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The programming support described in 
this publication may be used with one or 
more IBM 2260 Display Stations connected to 
an IBM System/370 central processing unit. 
Each display station is associated with an 
IBM 2848 Display Control, which is con- 
nected directly to the processing unit 
tnrough either a multiplexer channel or a 
selector channel. 


In this configuration, which is referred 
to as the “IBM 2260 Local,™ and in the “IBM 
2260 Remote" configuration described below, 
the display station may be located anywhere 
within a 2000-foot cable distance from the 
display control. 


By using the IBM 2701 Data Adapter Unit 
and appropriate common carrier facilities, 
aGisplay controls may be located any dis- 
tance from the central processing unit. 
This configuration, which is referred to as 
the “IBM 2260 Remote,“ is supported under 
OS/VS BTAM. 


CONFIGURATIONS AND FEATURES 


There are two models of the IBM 2260 
display station, Models 1 and 2. Each is a 
cathode-ray tube (CRT) display and is 
available with or without an alphameric, 
numeric, or data entry keyboard. The 
optional keyboard makes man-machine com- 
munication possible on a continuing basis 
at the display station. Other special fea- 
tures available with the IBM 2260 Local are 
Line Addressing and Nondestructive Cursor. 


GENERAL INFORMATION 


The IBM 2848 Display Control contains 
the interface control, a character genera- 
tor, and buffer storage for the display 
Stations. This buffer storage retains the 
video data to maintain display regeneration 
on the CRI. The data formats and number of 
characters that may be displayed on the 
face of the CRT, as well as the number and 
model of display stations that may be 
attached to a single display control, 
depend on which model of the display con- 
trol is used, as shown in Figure 1. 


Models 21 and 22 of the IBM 2848 provide 
Special capabilities for aiding data entry 
applications. These include extra keyboard 
character buffering and input/output com- 
mands that cause the keyboard of the 
addressed display station to remain mechan- 
ically locked to gain the attention of the 
operator. Models 21 and 22 may be used 
only in combination with an IBM 2260 Model 
2. 


In addition, one IBM 1053 Printer Adapt- 
er Unit may be attached to each display 
control. This feature allows an IBM 1053 
Printer to be used at a central location to 
document and record periodic system trans- 
actions. Like the display stations, the 
1053 printer may be located up to 2000 feet 
from the display control. 


The programming services described in 
this publication support all of the option- 
al features of both the IBM 2260 and the 
IBM 2848 described in detail in IBM System/ 


360 Component Description: IBM 2260 Dis- 
play Station; IBM 2848 Display Control. 


i a Nt i i ca ca cs a ls A a es lea ees —~—--—-—-——-—-—-—-—~-4+-----—-——-—-~--—-— 4 --~-~-------- tween tae ee 


eee eA er Serer De ee OOO Re soe pon 
{ Characteristic |} Model 1 | 
|---------------------- +------------ {-------- 
| Model No. of Display | 2 | 2 
| Stations to be Used | | 
pe a eae oe 4 f + 
| Max. No. of Display | 24 | 16 
{ Stations | | 
—-—--———-— —— ~~ + +---~---—--—-——-—-—4--—------ 
| No. of Lines of | 6 | 12 
| Characters | | 
Sle areata ele ee 4..-—~—~———-——-4{-__-_----— 
| No. of Characters { 40 { 40 
| Per Line | | 
4 4 
| Total No. of Charac- | 240 | 480 
j ters | | | 
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Figure 1. Display control characteristics 
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| | | | 
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| | | ( 
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PROGRAMMING SUPPORT 


Operating system programming support for 
the IBM 2260 Display Station includes macro 
instructions and control routines. They 
are used for two functions: input/output 
control and attention handling. The macro 
instructions function as part of the appli- 
cation program; the control routines func- 
tion as part of the control program. This 
programming support constitutes a graphics 
access method for the 2260 display station. 


The following paragraphs contain brief 
descriptions of the graphic programming 
services that are explained in detail in 
later sections. Appendixes include a 
sample program and CCW formats. 


INPUT/OUTPUT CONTROL 


Input/output control macro instruc~ 
tions are used for data transmission and 
control functions, for creating data con- 
trol blocks (DCBs), and for establishing 
and terminating system communication 
between problem programs and display sta- 
tions. Input/output control routines cre- 
ate channel command words (CCWs), issue 
supervisor calls to execute channel pro- 
grams, and control data transmission 
between main storage and display station 
buffer storage. 


ATTENTION HANDLING 


Attentions are asynchronous (unsched- 
uled) input/output interruptions of the 
CPU. They are caused by entries at a key- 
board attached to a 2260 display station. 


Basic Attention Handling 


Basic attention handling facilities 
automatically detect the occurrence of 2260 
attentions, and the control program routes 
them to the specified application program 
routines for handling. Through a set of 
macro instructions provided by graphic pro- 
gramming services (SAEC, SPAR, ATTNINQ, and 
DAR), the application programmer defines 
his attention handling routines and makes 
them accessible to the control program. 


Express Attention Handling 


Express attention handling facilities 
enable the application programmer to check 
for the occurrence of 2260 attentions 
through a set of macro instructions pro- 
vided by graphic programming services (ANA- 
LYZ and GSERV). Detection of attentions is 
not automatic; the application program must 
check periodically for their occurrence, so 
that attentions are not lost. When atten- 
tions are detected, control is transferred 


with OS/VS2. 


to the specified application program rou- 
tines. (Express attention handling is 
described in Appendix C.) 


ERROR HANDLING 


Synchronous errors (that is, input/ 
output errors that occur during channel 
operations) are handled by the IBM 2260 
Standard Error routine. This module tests 
the status and sense bytes for synchronous 
error conditions and provides appropriate 
error-recovery procedures for specific 
error situations. 


The IBM 2260 Standard Error routine pro- 
vides a message to the operator whenever 
operator intervention is required, or 


whenever a bus out check or equipment check 


occurs. These messages appear in the OS/ 
VS1 and OS/VS2 system messages manuals. 


PROBLEM DETERMINATION 


For information to help determine and 
solve problems that involve display pro- 
grams that use graphic programming services 
(GPS) for the 2260 display station, see 
OS/VS Problem Determination Aids and Mes- 
sages and Codes for GPS’and GSP. This 
manual, which is intended mainly for dis- 
play operators and application programmers, 
includes: 


Display operator aids for image pro- 
blems, interaction problems, messages, 
job termination, and collecting problem 
data. 


Application programmer aids, including 
summaries of completion and return 
codes, explanations of write-to- 
programmer messages issued by GPS, pro- 
cedures for using the Generalized Trace 
Facility (GTF), and descriptions of 
problem-related data to be collected. 


SYSTEM GENERATION 


The 2260 programmer defines his graphic 
configuration to the operating system by 
using appropriate system generation macro 
instructions. System generation require- 
ments are described in the OS/VS1 and OS/ 
VS2 system generation reference manuals. 


OS/VS2 


The graphic programming services 
described in this publication can be used 
When special considerations 
apply to the use of these services in a VS2 
environment, these considerations are noted 


at the end of the section to which they 
apply. 


FORMAT ILLUSTRATION CONVENTIONS 
Each macro instruction discussed in this 


publication is illustrated by the following 
coding format: 


acc mand Se ge ee eee 1 
|\Name |Operation |Operand | Comments | 

-~---}----------}--------------}--------] 
|Symbol|Macro name|None, or one | | 

or | Jor more oper- | | 
jblank | jands separated| | 
[ | [by commas | | 
ee 


The coding format illustrations use the 
following conventions: 


* Upper case (capital) letters, numbers, 
and punctuation marks must be coded by 
the programmer exactly as shown. | 
Exceptions to this convention are 
brackets, { ], braces, {i }, and 
ellipses, ... . These three exceptions 
are never coded. 


e Lower case (small) letters represent 
variables for which specific informa- 
tion or specific values must be substi- 
tuted by the programmer when coding. 


e Items within brackets, [ ], are option- 
al. They may be omitted at the pro- 
grammer's discretion. 


e Braces, { }, indicate that one operand 
from the group must be chosen unless a 
default option is indicated. 


e Underscoring indicates a default 
option; if no operand is coded, the 
underscored operand is assumed. 


e The vertical stroke ( | ) Signifies 
exclusive “or." For example, A|B means 
the programmer may write A or B. 
Alternative operands are also indicated 
by vertical grouping within braces { }. 


e® An ellipsis, ... , denotes that the 
preceding syntactical unit (enclosed in 
braces or brackets) can be written any 
number of times. 


e Operands are separated by commas. 


e All operands are written on one line of 
a coding sheet (unless a continuation 
card is used); they may appear on two 
or more lines in the format 
illustration. 


e The last operand is always followed by 
a blank. 


Positional operands must be coded in the 
order shown in the appropriate format il- 
lustration. Keyword operands may be writ- 
ten in any order, but must follow all posi- 
tional operands. Commas must appear in 
place of omitted operands preceding the 
last-specified positional operand. 


To determine how the operands are to be 
coded when substitution is required, a Sum- 
Mary of Operands is provided in Appendix D. 
This appendix contains all macro instruc- 
tions and indicates the method of writing 
operands. The summary is designed so it can 
be opened and the macro instructions dis- 
played while the descriptions are read. The 
classifications used in the summary are: 


SYM 
is any symbol valid in the assembler 
language. 

DEC INT 

are any decimal digits up to the value 

indicated in the associated macro 

instruction description. If both SYM 
and DEC INT are checked, an absolute 
expression is also allowed. 

REGISTER 

is always coded within parentheses as 

follows: 

(2-12) - one of general registers 2 
through 12, previously loaded 
with the right-adjusted value 
or address specified in the 
associated macro instruction 
description. The unused 
high-order bits must be set 
to zero. The register may be 
designated by either an abso- 
lute expression or a symbolic 
name enclosed in parentheses. 

(1) - general register 1, previous- 
ly loaded as indicated above. 
The register can be desig- 
nated only as (1). 

RX TYPE 


any address that is valid in a RxX-type 
instruction (for example, LA) may be 
designated. 


A-TYPE ADCON TYPE 
any address that may be written in an 
A-type address constant may be 
designated. 


Indexing or register notation cannot be 
used if the L form of a macro instruction 
is used or if the macro-form (MF) operand 
is omitted; only relocatable expressions, 
absolute expressions, or codes may be used. 
When using the L-form of a macro instruc- 
tion, the name field should contain a sym- 
bolic reference. 
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Unless otherwise noted, numeric values 
indicated as macro instruction operands are 
decimal integers, and they need not be pre 
ceded by leading zeros. 


Unless otherwise noted, omission of the 
macro~form (MF) operand causes a macro 
instruction to perform both L and E func- 
tions, that is, to derive a parameter list 
from all the operands specified and, at 
execution time, to execute the macro 
instruction using that list. 


LINKAGE CONVENTIONS 


Linkage conventions described in OS/VS 
Supervisor Services and Macro Instructions 


apply to the programming support described 
here. Information about register assign- 
ments for specific linkage functions can be 
found in that publication. 


TERMINOLOGY 


In this publication, “display station 
buffer storage" refers to the buffer 
storage physically located in the display 
control unit, and the unqualified term 
"register" means “general register." 


IBM Data Processing Glossary contains a 
glossary of terms used in this and other 


OS/VS publications. 


Input/output control is achieved through 
macro instructions and associated control 
routines which together initiate input/ 
output operations associated with data dis- 
play. The input/output macro instructions 
and their functions for the IBM 2260 Dis- 
play Station are listed in Figure 2. 


Note: The address of the application pro- 
gram save area must be loaded into register 
13 before any input/output macro instruc- 
tion is issued. 


BACKGROUND INFORMATION 


To help the reader better understand a 


discussion of input/output operations, the the DEB list of UCB pointers. The value of 
following paragraphs briefly describe the the "unit" operand, expressed as a decimal 
functional relationships among the various integer, must not exceed the number of 
system control blocks associated with 2260 devices specified on the data definition 
input/output operations under the operating (DD) card for the data set. 

system. 

Normally, each data control block (DCB) A DD statement can refer to any display 
is established by a DCB macro instruction Station or 1053 printer singly or to any 
and completed by execution of an OPEN macro group of display stations (up to 24) 
instruction. The DCB, wnich contains a together with a 1053 printer connected to 
reference to a DD statement (see below), the same display control. All units of a 
may be associated with one display station group need not be specified in one DD sta- 
Or With a group of display stations con- tement; subsequent DD statements can refer 
nected to a single 2848 display control. to the unspecified units in that group. 
More than one DCB may be completed by a Information about data definition specifi- 
Single OPEN macro instruction. The OPEN cations can be found in OS/VS JCL 
macro instruction creates a data extent Reference. 
fee eee Pe ae gee ee a et eee Dr ye Gee FS ee ee ey ee 1 
{| Mnemonic | Macro Instruction Name | Function | 

--------- 4-----------------~------------}-------------------------—---------------------+ 
| DCB {| Data Control Block | Establishes the data control block (DCB). ; 
~--------- |-----------------------------|---------------------------------------------} 
| OPEN | Open Data Control Block | Initializes one or more data control blocks. | 
---------- }-----------------------------}---------------------------------------------- 
| GREAD | Read Character Data | Txransmits data from the display station i 
| | | buffer storage to main storage. | 
}---------- }----------------------------- }--------------------—------------------------- : 
| GWRITE | Write Character Data {| Transmits data from main storage to the dis- | 
{ { | play station buffer storage or to a 1053 | 
| i {| printer. | 

—---~---- |-~------~------~--------- += enn en nnn nnn 
{| GCNTRL | Erase Display Station | Erases data from the display station buffer | 
| | Buffer Storage {| storage. { 
|---------- }----------------------------- }---------------------------------------------- 4 
| CLOSE { Close Data Control Biock | Disassociates one or more data control { 
| | | blocks. 
|---------- }----------------------------- }---------------------------------------------- { 
{ WAIT {| Wait for One or More Events | Relinquishes control of the CPU until the | 
| | {| completion of one or more input/output | 
{ | | operations. [ 
ie ea ene ee se i BD sar Pea a aa ae ae hs ee ak J 
Figure 2. Input/output macro instructions 
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INPUT/OUTPUT CONTROL 


block (DEB) in protected main storage. 
Included in the DEB is a table of address 
pointers to specific unit control blocks 
(UCBs) associated with the data control 
block. One UCB is Specified for each dis- 
play station and for each 1053 printer 
attached to a 2848 display control. The 
UCB is used to describe its associated 
device to the control program. 


Some input/output macro instructions 
contain a “unit" operand. The "unit" 
operand refers to a device within a group 
of devices that can be named during system 
generation. This operand is used as an 
index to reference the desired element in 


The value of the “unit" operand decre- 
mented by 1 is placed in the data event 
control block (DECB) when it is generated 
during macro expansion ("unit"” - 1 = UCB 
index). At execution time, the input/output 
control routine places this value into the 
input/output block (IOB). This completes 
the linkage between the input/output macro 
instruction and the selected UCB, which in 
turn points to the device associated with 
the macro instruction. 


INPUT/OUTPUT MACRO INSTRUCTIONS 


The macro instructions in this group 
implement 2260 input/output functions, 
which include defining certain control 
biocks and controlling data transmission 
between main storage and the display sta- 
tion buffer storage. These macro instruc- 
tions provide linkage to the input/output 
control routine that creates the IOB, con- 
structs channel programs, and issues cal- 
ling sequences to execute the channel 
programs. 


All input/output macro instructions 
except the DCB macro instruction may use 
the L- and E-forms of macro definition. If 
all operands except the MF=L or MF=E key- 
word operand are written, the input/output 
function is executed using the specified 
operands. If any required operand is mis- 
Sing at execution time the task is ter- 
minated. Detailed descriptions of these 
forms and their use are found in OS/VS Data 


Management Macro Instructions. 
A 32-byte DECB is formed during macro 


expansion, and the parameters derived from 
the macro instruction operands are inserted 


Re EN AA CATION NOD AS AO concen cE LTTE VTA RD ee 
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into appropriate positions in the DECB. 
This data is utilized by the input/output 
control routine to generate the CCWs. The 
format of the DECB for the IBM 2260 Local 
is shown in Figure 3. 


DCB -- Data Control Blotk .Macro Instruction 


The DCB macro instruction for the IBM 
2260 Local reserves space for the data con- 
trol block and establishes its format (see 
Figure 4). In addition to the basic infor- 
mation required in the DCB, space is also 
reserved for addresses of the input/output 
control routine and the input/output block, 
which are supplied at open time. One DCB 
services a maximum of 24 display stations 
and one 1053 printer attached to the same 
display controi. The format of the DCB 
Macro instruction is: 


Operand | 


ame cone came enen comme sD em ane sume eee sete: eee nee a eee wee oom 


I t 

| [Symbol] | DCB 
| 
| 
| 
| 
| 


de See eee 
| DSORG=GS, MACRF=code 

| {, GTYPE={BASIC | EXPRESS} ] 

| C, DDNAME=ddname] 
| 
| 
| 
1 


ee 


| 
| [, EXLST=exit list address] | 
| {,GNCP=number of blocks] | 
| 
een costae ee 4 


ee ee ee ee a ND eS AD A SE OS AES ED ED RD A ED ED SUED SUD SEEN GENS GEND GRDED GED EURSD GERD GED END OUND SED SAME ORE. 


DSORG=GS 
specifies that a graphic data control 
block is defined. This operand is 
required for macro expansion. 


MACRF= 
' gpecifies the type or types of macro 
instructions to be used, where R indi- 
cates GREAD, W indicates GWRITE, and C 

indicates GCNTRL. The following are 


r a aa a aa a a a te ers rer 
| Offset from | | Associated I/0 | 
| DECB Name | | Macro Instruction | 
H (bytes) DECB Field | Operand | 
| --~---~~~----~4-~--------------------------------------------------- $~----------------- - 
| +00 | Event control block (ECB) | | 
| +04 | Type code | type | 
i +08 { Data control block (DCB) address [ dcb address | 
i #12 j Area address { area address | 
| +16 {| Code for incorrect length or permanent read error | | 
i +17 ij Residual count from CSW if incorrect length { | 
i +20 i Length (byte count) | length [ 
i #24 i (Reserved) | [ 
| +28 | Index to reference an element in the DEB table of | unit | 
| i address pointers to UCBs associated with the DCB | | 
i +29 {| Zero (the low order bit of this byte is set to one | [ 
{ i when data entry type codes are specified) | [ 
i +30 i Zeros | | 
i +31 j Zeros [ | 
nena ee ee ree meee aga a SS a a lta a a a ce a A ee nS ee DO pee ene J 


Figure 3. Format of the DECB 


ee eee er ee eg eR ey ee er Oe ee ee ee ae eee ge ne 1 
| Offset from | { 
{| DCB name | { 
| (bytes) | DCB Field | 
|--------------}-------------------------------------- + ---- ++ ----+-----+---------4 
i +0-13 | Reserved | 
| +14 | GTYPE--Specifies basic or express attention handling procedures | 
| #15-25 | Reserved | | 
| 426-27 | DSORG--Specifies a graphic data control block [ 
| +28-31 | Reserved | 
| +32 | GNCP--Maximum number of I/O macro instructions issued before a [ 
| | WAIT macro instruction is issued { 
| +33-35 | POLST--Address of list of DCB addresses used in express | 
| | attention handling | 
| +36 | Reserved | 
| +37-39 | EXLST--Address of application program exit list for exceptional | 
| | conditions | 
| +40-47 | DDNAME--Corresponds to name of data definition (DD) statement | 
i +48-49 | Reserved { 
| #50-51 | MACRF--Types of I/O macro instructions used in problem program | 
Re Se De a el 4 


Figure 4. Data control block elements 


the eight valid codes for the MACRF 
operand. 


(R, WC) 
(RC ,WC) 


GTYPE= 
specifies whether basic or express 
attention handling procedures are to 
be employed. If this operand is 
omitted, express attention handling is 
assumed. 


DDNAME= 
Specifies the name of the DD statement 
describing the data set being pro- 
cessed. DDNAME corresponds exactly to 
the contents of the Name field of the 
DD statement provided in the job con- 
trol language. It can be defined by 
as many as eight characters, the first 
of which must be a letter. DDNAME 
furnishes a logical connection between 
the DD statement and the data control 
block of the application program. 


EXLST= 
specifies the address of the exit list 
in the application program as defined 
in OS/VS Data Management Macro 
Instructions. If EXLST is not speci- 
fied, a value of zero is assumed. 


GNCP= 
Specifies the maximum number of input/ 
output macro instructions that can be 
issued before a WAIT macro instruction 
(that is, the number of input/output 
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biocks constructed at open time). The 
value of GNCP must be from i to 99 at 
execution time. If the value of GNCP 
is not specified, a value of one is 
assumed. The programmer may specify a 
value of zero at assembly time, but 
must respecify the value within the 
above range at execution time. If the 
value zero is present at open time, 
the job is abnormally terminated. 


POLST= 


is the address of the location in main 
storage, reserved by the application 
programmer, where a list of DCB 
addresses is constructed by the OPEN 
Macro instruction. This list of DCB 
addresses, called a poll list, is used 
with express attention handling faci- 
lities by the OPEN, CLOSE, GSERV, and 
ANALYZ macro instructions as described 
in Appendix C of this publication. 

The first entry in the poll list 
points to the last entry. (It must 
Oorigiially be set to zeros.) As addi- 
tional devices are opened, the DCB 
addresses are added to the poll list. 
The length of the area needed to con- 
Struct the list is nti fullwords, 
where *n" is the number of devices for 
which the DCB is opened. If the app- 
lication programmer wishes to open 
multiple DCBs using the same OPEN 
macro instruction, he must use the 
same POLST operand with each DCB macro 
instruction he issues. He may use the 
same POLST operand or different POLST 
operands when issuing other OPEN macro 
instructions. If more than one poll 
list is created, each requires a 
separate ANALYZ macro instruction. If 
POLST is not specified, a value of 
zero is assumed. This operand is used 
only with express attention handling. 
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PROGRAMMING NOTES: The application pro- 
grammer may create a DCB at assembly time 
by using the DCB macro instruction. Data 
definition (DD) card information may be 
supplied by the programmer at execution 
time. The GNCP operand may be specified at 
execution time by a DD card, provided GNCP 
is set to zero at assembly time. 


The application programmer can create 
his own DCB by using a constant area. In 
this case he may specify both the DSORG and 
GNCP operands in a DD card. By ensuring 
that this area contains the same informa- 
tion at the same locations as the DCB 
created by the DCB macro expansion (see 
Figure 4), the programmer can effectively 
create a DCB. The DD name of the DD card 
must be identical to the DD name set up in 
this area (offset 40 through 47). For 
information on coding of the DD card, refer 
to OS/VS JCL Reference. 


The data control block assembled from a 
DCB macro instruction will not have names 
associated with the individual fields that 
comprise the control block. To refer or 
gain access to the fields in the data con- 
trol block, the application programmer can 
write a DCBD macro instruction as follows: 


DCBD DSORG=GS 


The name field must be ieft blank, and only 
the DSORG operand is specified. 


The DCBD macro instruction generates a 
DSECT statement that provides a symbolic 
name for the fields within a data control 
block. Each field is defined so that with 
proper initialization of base registers, 
the programmer can refer to any or all 
fieids of one or more data control blocks. 
The macro instruction expands as follows: 


+* DCB SYMBOLIC DEFIN- 
+ ITION FOR GRAPHICS 
+% WITH APPENDAGES 
+IHADCB DSECT 

+ . ORG IHADCBtO 

+* GRAPHIC DEVICE 

+* LNTERFACE 

+ DS BL4& 

+ DS BL4 

+ DS BL4& 

+DCBBRSA DS AL2 

+DCBGTYPE DS BLi 

+ DS BL1 

+DCBBFRST DS AL2 

+DCBBFRSZ DS AL2 


$e 


+ 
+ 
+DCBDSORG 
+DCBIOBAD 


+* 


+ 
+DCBGNCP 
+DCBPOLST 
+DCBEXLST 


+* 
+* 


+ 
+DCBDDNAM 
+DCBOFLG 
+DCBIFLG 
+DCBMACR 


+% 
+* 


+ 
+DCBTIOT 
+DCBMACRF 
+DCBIFLGS 
+DCBDEBAD 
+DCBOFLGS 
+DCBGIOCR 


COMMON 


THADCB+20 
BL6 

BL2 

A 


FOUNDATION EXTENSION 
IHADCB+t 32 
OBL1 
A 
A 


FOUNDATION BEFORE 
OPEN 


IHADCBt 40 
CL8 


FOUNDATION AFTER 
OPEN 


ITHADCB+t40 


For more information, see OS/VS Data 
Management Macro Instructions. 


OPEN -- Open Data Control Block Macro 
Instruction 


The OPEN macro instruction for the IBM 
2260 Local initializes one or more data 
control blocks that establish a communica- 
tion path between the application program 


and the display station. 


OPEN performs the 


following functions: 


Indicates that the display station is 
"open" by setting the appropriate bit 


in the DCB. 


Fills in and initializes appropriate 
fields in the DCB. 


Acquires main storage to initialize a 
chain of IOBs and associated channel 
programs. 
IOB to its CCW list and to the next IOB 


in the chain. 


Linkage is provided in the 


The number of IOBs con- 


structed is one greater than the number 
specified by the GNCP operand, unless 


GNCP is equal to 99. 


(No more than 99 


IOBs may be constructed for each DCB.) 
The additional IOB is constructed in 
order to always ensure the availability 


of an IOB, 3 
structed dynamically. 


since IOBs are not con- 
A pointer to the 


top of the chain of IOBs is placed in 
the DCB. 


e Loads the. graphic I/O control routine 
and places its address in the DCB. 


e Performs initialization functions 
required by attention handling facili- 
ties. If the POLST operand was speci- 
fied in the DCB macro instruction, a 
DCB address list (poll list) is con- 
structed. OPEN provides one POLST 
entry for every display station that 
the user wants polled. This function 
applies only to 2260s equipped with an 
optional keyboard feature. 


The format of the OPEN macro instruction 
is: 


aaa reais 2 Raa Co ee ee ee ee 1 
{ Operation |Operand { 
~~------}---------}----------------------] 
| [symbol] | OPEN | (dcb address | 
{ I [{,,dcb address]...) | 
| | | {(,MF={L| (E, parameter 

| | | list name) | (E, (1))3] | 


hoe eae ae ea ee oe eee ee 


dcb address 
specifies the addresses of the DCBs to 
be initialized for the desired graphic 
device(s). Any number of DCB address- 
es may be specified. This allows 
paraliel opening of DCBs and their 
associated data sets. If more than 
one DCB address is specified, the “dcb 
address“ operands must be separated by 
two commas. The second comma indi- 
cates omission of optional operands 
not applicable to graphic programming 
services. 


MF=L 
specifies that expansion of the macro 
instruction is to consist of a parame- 
ter list only. The name assigned to 
the parameter list is the symbolic 
name specified in the Name field of 
this OPEN macro instruction. 


MF=(E, parameter list name) 
specifies that the macro instruction 
is to perform the open function using 
a parameter list created by another 
OPEN macro instruction. The open 
function is executed for each “dcb ad- 
dress" operand in the list. The “pa- 
rameter list name" operand must corre- 
spond exactly to the name specified in 
the Name field of the OPEN macro 
instruction used to construct the pa- 
rameter list. 


MF=(E, (1)) 
performs the same function as (E,. 
parameter list name). By writing the 
Special register notation (1), the 


EXAMPLES : 


programmer specifies that he has 
loaded the address of the parameter 
list into register 1 before execution 
of the macro instruction. 


PROGRAMMING NOTES: If a task attempts to 
open a DCB that was already opened by 
another task, the task is abnormaily ter- 
minated. If a task attempts to open a gra- 
phics DCB for a nongraphics device, the 
task is abnormally terminated. If a task 
attempts to have OPEN construct a number of 
IOBs that is not in the range 1 through 99, 
the task is abnormally terminated. Write- 
to-programmer messages are issued for these 
error conditions. For message explanations 
and programmer error checks, see OS/VS Pro- 


blem Determination Aids and Messages and 
Codes for GPS and GSP. 


If the “dcb address” operand of the OPEN 
Macro instruction specifies a DCB that was 
already opened (by the same task), no 
action results. Opening when a correspornd- 
ing DD statement has not been provided 
causes no error indication; however, an 
attempt to use the data set will result in 
an abnormal termination of the task. 


If the device specified on the DD card 
is not a graphic device, an invalid UCB 
results, and the task is abnormaily 
terminated. 


In the second and third 
examples, DCB1 and DCB2 are initialized 
using the parameter list constructed by the 
first example. In the third example, the 
location of the parameter list has been 
loaded into register 1. 


EXAMP1 OPEN (DCB1, , DCB2) , MF=L 
EXAMP2 OPEN MF=(E, EXAMP1) 
EXAMP3 OPEN MF=(E, (1)) 

GREAD -~- Read Character Data Macro 
Instruction 


The GREAD macro instruction transmits 
data from the display station buffer 
storage to main storage. There are six 
possible read operations performed by the 
GREAD macro instruction depending upon the 
"type" operand specified. The format of 
the GREAD macro instruction is: 


7 
| 
abet ieee ele eat eee eed aris oles aes 4 
{decb name i 
| | ,type | 
| | ,dcb address i 
| |, Clength] | 
| |,area address | 
| jC, unit] | 
| | (,MF={L|E}] [ 
4 J 
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decb name 
is the name assigned to the data event 
control block generated in the macro 
expansion. This operand is required 
for macro expansion. 


type | 
specifies the type of read operation. 
This operand is required for proper 
macro expansion. The following are 
the valid forms of the operand (each 
“type” is described following the dis- 
cussion of all other operands related 
to the GREAD macro instruction): 


DSM 
Read Display Station Manual Input Mes- 
sage for the 2260. 

DSMW 
Read Display Station Manual Input Mes- 
sage Without Keyboard Restore for the 
2260. 

SMI 
Read Display Station Short Manual 
Input Message for the 2260. 

SMIW 
Read Display Station Short Manual 
Input Message Without Keyboard Restore 
for the 2260. 

DSB 
Read Full Display Station Buffer 
Storage for the 2260. 

DSBW 
Read Full Display Station Buffer 
Storage Without Keyboard Restore for 
the 2260. 


dcb address 
is the address of the data control 
block associated with the graphic 
device. 


length 
is the number of data bytes to be 
read. 


area address 
is the address of the main storage 
location into which the first byte of 
data will be read. 


unit | 
is a decimal integer; it is used to 
create an index to the desired element 
in the DEB table (address pointers to 
UCBS associated with the DCB). The 
indicated UCB contains the address of 
the desired device. The value of 
“unit™ must be in the range 1 to N, 
where N is the number of devices spe- 
cified on the data definition card for 
this data set. N cannot exceed 25 
(the maximum configuration is 24 dis- 
play stations and one 1053 Printer per 
display control). 


Caution: When using register nota- 
tion, the contents of the register, at 
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execution, must be one less than the 
value of the “unit" operand described 
above. 


Notes The device indicated by “unit" 
cannot be the 1053 printer. 


Omission of the “unit" operand 
results in the value one being 
assigned to “unit", indicating the 
first element in the DEB table. 


MF=L 
specifies that expansion of the macro 
instruction is to consist of a parame- 
ter list only. The name assigned to 
the parameter list is the name speci- 
fied by the “decb name™ operand of 
this GREAD L-form macro instruction. 


MF=E 
specifies that the macro instruction 
is to perform the read operation using 
a parameter list constructed by anoth- 
er GREAD macro instruction. The first 
operand in the E-form macro instruc- 
tion must correspond exactly to the 
name of the parameter list. The pa- 
rameter list may be updated at execu- 
tion time by specifying new values in 
any of the operands preceding the MF=E 
keyword operand. 


A “type™ operand, specified in an L-form 
macro instruction, may be modified by a 
corresponding E-form macro instruction. 
Other operands required for execution that 
were not specified in an L-form macro 
instruction should be specified in the 
corresponding E-form macro instruction. 


Note: A unique name must be assigned to 
each parameter list defined. Use of the 
same DECB name for more than one DECB 
results in a multiple definition error at 
assembly time. 


If neither the MF=L nor MF=E keyword 
operand is written, all required operands 
must be coded to achieve executable macro 
expansion. Omission of the “decb name" 
operand prevents macro expansion; omission 
of other operands produces error messages 
on the assembly listing, but does not ter- 
mMinate macro expansion. 


TYPES OF READ OPERATIONS: The six types of 
read operations for the 2260 are described 
below. 


DSM (Read Display Station-Manual Input Mes- 
sage): This “type"™ operand causes charact- 


er data in the selected display station 
buffer storage to be transferred to main 
Storage by the display control. DSM can be 
used only if an optional keyboard feature 
is available. Starting with the first dis- 
play position following the start symbol, 


character data will be sequentially retri- 
eved and transferred until the end of mes- 
sage is detected or the channel byte count 
is reduced to zero. The start symbol is 
then cleared. Data on the same line and to 
the right of a new line symbol is not 
transferred. The new line symbol is trans- 
ferred. If the check symbol is present, it 
is transferred. The end of message code is 
not transferred to main storage. The dele- 
tion of the start symbol is the only change 
to the CRT display; the data is not changed 
or destroyed by the read operation. 


One channel command word is generated by 
GREAD, “type™ DSM: the Read Display Sta- 
tion Manual Input Message CCW, which 
initiates the read operation. 


DSMW_ (Read Display Station Manual Input 


Message Without Keyboard Restore): The 
Operation caused by this “type™ operand, 


which can only be used with IBM 2848 Models 
21 and 22, is identical to DSM, except that 
the keyboard remains mechanically locked at 
the completion of the operation. 


One channel command word is generated by 
GREAD, “type"™ DSMW: the Read Display Sta- 
tion Manual Input Message Without Keyboard 
Restore CCW, which initiates the read 
operation. 


SMI (Read Display Station Short Manual 
Input Message): The operation caused by 
this “type" operand is identical to DSM, 
except that the start symbol is not erased 
when the end of message is detected or the 
channel byte count is reduced to zero. 
Consequently, keyboard lockout time is sub- 
stantially less for the SMI “type™ operand 
than for the DSM “type™ operand. fMThis is 
an important consideration for applications 
involving a high rate of data input and 
multiple 2260s attached to one 2848. 


One channel command word is generated by 
GREAD, “type" SMI: the Read Display Sta- 
tion Short Manual Input Message CCW, which 
initiates the read operation. 


SMIW (Read Display Station Short Manual 


Input Message Without Keyboard Restore): 
The operation caused by this “type" 


operand, which can only be used with IBM 
2848 Models 21 and 22, is identical to SMI, 
except that the keyboard remains mechani- 
cally locked at the completion of the 
operation. 


One channel command word is generated by 
GREAD, “type" SMIW: the Read Display Sta- 
tion Short Manual Input Message Without 
Keyboard Restore CCW, which initiates the 
read operation. 


DSB (Read Full Display Station Buffer): 
This “type" operand causes a maximum of 


240, 480, or 960 data bytes to be trans- 
ferred, depending upon the size of the 
addressed display station buffer. The 
first symbol transferred is the first sym- 
bol in the upper left-hand corner of the 
CRT, and the last symbol transferred is the 
last symbol in the lower right-hand corner 
of the CRT. If no character is found ina 
displayable position, a space is trans- 
ferred. If the addressed buffer has the 
optional nondestructive cursor feature, the 
cursor position is not indicated by the 
data transferred. If the addressed buffer 
has a standard destructive cursor feature, 
the cursor position is indicated by the 
location of the end of message code. (For 
more information about the cursor features 
and the end of message code, see the 2260 
component description.) The check and 
Start symbols are transferred if they are 
present. The codes are: 


bit 01234567 
Destructive cursor 011031010 
Check symbol 01111111 
Start symbol 01003131010 


The CRT is erased after the operation, 
and the cursor is placed in the first cur- 
sor position (upper left-hand corner) of 
the CRT. 


Multiple channel command words are 
generated by GREAD, “type™ DSB. First, the 
Read Full Display Station Buffer CCW is 
issued, which initiates the read operation. 
Second, the Erase Display Station Buffer 
Storage CCW is issued, which deletes all 
character data from the display station 
buffer storage and resets the cursor to the 
first display position of the CRT. 


DSBW (Read Full Display Station Buffer 
Without Keyboard Restore): The operation 
caused by this “type" operand, which can 


only be used with IBM 2848 Models 21 and 
22, is identical to DSB, except that the 
keyboard remains mechanically locked at the 
completion of the operation. 


Multiple channel command words are 
generated by GREAD, “type"™ DSBW. First, 
the Read Full Display Station Buffer 
Without Keyboard Restore CCW is issued, 
which initiates the read operation. 
Second, the Erase Display Station Buffer 
Storage Without Keyboard Restore CCW is 
issued, which deletes all character data 
from the display station buffer storage and 
resets the cursor to the first display 
position of the CRT. 


Input/Output Control 11 


PROGRAMMING NOTES: If the chumiei byte 
count in the CCW reaches zero, 2 stop © 
sequence is generated by the channel. Dur- 
ing a read operation, receipt of the stop 
Sequence terminates transmission of data 
from the display control to main storage. 
The display control continues reading data 
from the display station buffer storage but 
does not transfer data to main storage. 
Detection of the end of message when using 
DSM causes the display control to restore 
the keyboard of the selected display sta- 
tion and delete the start symbol. When SMI 
is used, the keyboard is restored and the 
Start symbol is not erased. When DSB is 
used, the display is erased at completion 
of the operation, and the cursor is reset. 
If an error is detected during execution of 
DSB, the erase operation is not performed. 
The application programmer, therefore, 
should ensure that the correct length is 
specified if he wants the erase operation 
to be performed. 


An unspecified “length” operand or zero 
entry results in the insertion of a byte 
count of 960 in the generated CCW. This 
assures that the stop sequence will not be 
encountered on read operations. If the 
"length" operand is incorrectly specified, 
an error message is printed on the assembly 
listing. 


ERROR CONDITIONS: If incorrect length | 
occurs during execution, the count from the 
CSW is placed in its appropriate location 
in the DECB (DECBt17 through 19), and a 
hexadecimal code of 43 is posted in the 
DECB (DECB+16). Since this case is not 
considered an error, a hexadecimal code of 
7F is also posted in the high-order byte of 
the ECB. If a permanent read error occurs, 
the screen is erased, the message ERROR ON 
READ is displayed, an error code of 41 is 
posted in the high-order byte (byte 0) of 
the ECB, and a hexadecimal code of 45 is 
posted in the DECB (DECB+16). Automatic 
retry is not provided, and the handling of 
the error is entirely the responsibility of 
the application program. 


Before processing the data obtained from 
a read operation, the application program 
should check the high-order byte of the ECB 
to determine whether the operation was suc- 
cessful. The program should then check 
bytes 16 through 19 of the DECB for more 
information about the completion condition. 
If the DECB is to be used for more than one 
input/output operation, the program must 
zero DECB byte 16 before execution of the 
next input/output operation. The indica- 
tions and conditions present when determin- 
ing the completion condition, and the read 
operation affected, are shown in Figure 5. 


a a Aa a ae a a aaa a a aa aa ev a | 
| Indication { Condition | Read Operation | 
|-----------------~--- }-------------------—---------------~----------- }----------------- { 
{1. ECB=7F | | { 
| DECB+16=0 {| Normal Completion {| DSM, DSMW, | 
| DECB+17=not used | | SMI, SMIW, DSB, | 
| | | DSBW | 
j2. ECB=41 | | | { 
| DECBt16=45 | Permanent Error | DSM, DSMW, | 
{| | DECB+17=not used | | SMI, SMIW, DSB, | 
| | DSBW | 
{3. ECB=7F | i { 
| DECB+16=43 {| Long Length Record | DSM, DSMW, SMI | 
| DECB+17=0 | (The CSW count reached zerce before the end of | or SMIW | 
| CSW count=0 | message symbol was detected) | [ 
| | (The CSW count reached zero before the full | DSB or DSBW | 
i | buffer was read) { | 
{|4. ECB=7F | i | 
| DECB+16=43 | Short Length Record | DSM, DSMW, | 
{ DECBt17=count | (The end of message symbol was encountered | SMI or SMIW | 
| CSW count not | before the CSW count reached zero) | { 
{ equal to initial | (The full buffer was read before the CSW | DSB or DSBW | 
| count and not zero| count reached zero) | | 
| | | | 
{5. ECB=7F { | | 
| DECBt16=43 | a. The ENTER key was depressed when the | DSM, DSMW, SMI | 
| DECB+17=initial [ start symbol was not on the screen | or SMIW | 
| count i b. A DSM was given when the ENTER key had | | 
| | not been depressed | | 
{ | c. The ENTER key was depressed before any | | 
| j data was entered (the start symbol is { | 
| | followed immediately by the cursor) | | 
ares ad ee ee i oe 


Figure 5. 
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Completion indications and conditions 


After execution of the macro instruc- 
tion, the program should check the hexadec- 
imal return code in register 15 to deter- 
mine whether execution was successful. 
Return codes and their meanings are: 


Return Code Meaning 

00 Normal 

10 DCB address is not in the DECB 

14 DCB addresses in the DECB and 
the IOB are not equal 

1c Type code is not in the DECB 

24 Area address is not in the 
DECB 

28 DCB addresses in the DECB and 
the DEB are not equal 

2C Unit index in the DECB exceeds 
units specified in the DD 
record 

3C Length in the DECB is negative 


Write-to-programmer messages are issued 
for the error conditions. For message 
explanations and programmer error checks, 
see OS/VS Problem Determination Aids and 


Messages and Codes for GPS and GSP. 


EXAMPLES: In the following example, a DECB 
named DECB1 is to be generated as part of 
the macro expansion. The “type™ operand 
Specifies that a DSM operation for the data 
set associated with the data control block 
INDCB will be performed. A length of 100 
bytes will be read into an area in main 
storage called INAREA. The value of the 
"unit" operand is one. In example 1, L- 
form is specified, which generates the 
parameter list. Example 2 shows coding 
when positional operands are omitted in an 
L-form GREAD. Example 3 shows the E-form 
GREAD with the length changed to 150 bytes. 
EXAMP1 GREAD DECB1 ,DSM,INDCB,100, 
INAREA, 1, MF=L 

DECB1 ,DSM,MEF=-L 
DECB1,,,150,MF=E 


EXAMP2 GREAD 
EXAMP3 GREAD 


Register Notation: The programmer may 
specify register notation, in which case 


the address of the DECB must be loaded into 
register 1 before execution of the macro 
instruction. Other positional operands may 
be loaded into other registers (2-12). For 
example: 


EXAMP1 LA 
GREAD 


1, DECB 
(1) ,MF=E 
or 


EXAMP2 LA 1,DECB1 
LA 2, INDCB 
LA 3, INAREA 
GREAD (1),, (2),, (3) ,MF=E 


When expressing the “unit"™ operand in 
register notation, the value loaded into 
the register is the same as the UCB index 
(unit-1) and is placed in the high-order 
byte of the register. 


GWRITE -- Write Character Data Macro 
Instruction 


The GWRITE macro instruction transmits 
data from main storage to the display sta- 
tion buffer storage or to a 1053 printer. 
There are eight possible write operations 
performed by the GWRITE macro instruction 
depending upon the “type" operand speci- 
fied. The format of the GWRITE macro 
instruction is: 


1 
| 
<e ane ene GoD ae ae DS ED ED GED AED ED EES CRD ana EP AD ND ED EE ERP AME NED AED AND CARD EN ETS ND AE AY A EY EN ES ES DY 4 
{|decb name [ 
type | 
Clength] | 
area address | 
| 

| 


[,unit] 
{, MF={L| E}] 
cia 


lay address 
le 
ls 
| 
| 


decb name 
is the name assigned to the data event 
control block generated in the macro 
expansion. This operand is required 
for macro expansion. 


type 
specifies the type of write operation. 
This operand is required for proper 
macro expansion. The following are 
the valid forms of the operand (each 
"type" is described following the dis- 
cussion of all other operands related 
to the GWRITE macro instruction): 


DSB 
Write Display Station Buffer Storage 
for the 2260, or Write 1053 Printer 
Buffer Storage for the 1053. 

DSBW 
Write Display Station Buffer Storage 
Without Keyboard Restore for the 2260. 

EBW 
Erase and Write Display Station Buffer 
Storage for the 2260. 

EBWW 
Erase and Write Display Station Buffer 
Storage Without Keyboard Restore for 
the 2260. 

LNE 
Write Display Station Line Address for 
the 2260. 
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LNEW 
Write Display Station Line Address 
Without Keyboard Restore for the 2260. 
EWL 
Erase and Write Display Station Line 
Address for the 2260. 
EWLW 
Erase and Write Display Station Line 
Address Without Keyboard Restore for 
the 2260. 


adcb address 
is the address of the data control 
block associated with a graphic 
device. 


length 
is the number of bytes of display data 
to be written. This includes the new 
line character and the line address 
control byte when used. 


area address 
is the address of the main storage 
location from which the first byte of 
display data is to be written. 


unit 
is a decimal integer; it is used to 
create an index to the desired element 
in the DEB table (address pointers to 
UCBS associated with the DCB). The 
indicated UCB contains the address of 
the desired device. The value of 
"unit" must be in the range 1 to N, 
where N is the number of devices spe- 
cified on the data definition card for 
this data set. N cannot exceed 25 
(the maximum configuration is 24 dis- 
play stations and one 1053 printer per 
display control). 


CAUTION: When uSing register nota- 
tion, the content of the register, at 
execution, must be one less than the 
value of the "unit" operand described 
above. 


Note: The 1053 printer can be indi- 
cated by “unit™ only when the "type" 
operand is written as DSB. 


Omission of the "unit" operand 
results in the value one being 
assigned to "unit", indicating the 
first element in the DEB table. 


=L 
Specifies that expansion of the macro 
instruction is to consist of a parame- 
ter list only. The name assigned to 
the parameter list is specified by the 
“decb" operand of this GWRITE L-form 
macro instruction. 
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MF=E 
specifies that the macro instruction 
is to perform the write operation 
using a parameter list constructed by 
another GWRITE macro instruction. The 
first operand in the E-form macro 
instruction must correspond exactly to 
the name of the parameter list. The 
parameter list may be updated at exe- 
cution time by specifying new values 
in any of the operands preceding the 
MF=E operand. 


A “type” operand, specified in an L-form 
macro instruction, may be modified by a 
corresponding E-form macro instruction. 
Other operands required for execution that 
were not specified in an L-form macro 
instruction should be specified in the 
corresponding E-form macro instruction. 


Note: A unique name must be assigned to 
each parameter list defined. Use of the 
same DECB name for more than one DECB 
results in a multiple definition error at 
assembly time. 


If neither the MF=L nor MF=E keyword 
operand is written, all required operands 
must be coded to achieve executable macro 
expansion. Omission of the “decb name" 
operand prevents macro expansion; omission 
of other operands produce error messages on 
the assembly listing, but do not terminate 
macro expansion. 


TYPES OF WRITE OPERATIONS: The eight types 
of write operations for the 2260 are 
described below. 


DSB (Write Display Station Buffer Storage): 
This "type" operand causes sequential bytes 


of character data to be transmitted to the 
display control in either of two modes 
depending upon whether the address is spec- 
ified as display station or 1053 printer. 


Upon recognition of the display station 
address by the display control, character 
data is placed into the display station 
buffer storage starting at the cursor sym- 
bol position. The cursor is automatically 
advanced to the next cursor position. The 
cursor is placed in the first display posi- 
tion (upper left-hand corner) of the CRT 
when a displayakle character is inserted 
into the last display position of the CRT. 


When the 1053 printer address is recog- 
nized by the display control, incoming 
character data is placed into contiguous 
print positions of 1053 buffer storage and 
the 1053 print operation is initiated. A 
new line character should be inserted at 
least after every 130th character; other- 
wise, overprinting results. 


If a write error occurs during execution 
of a GWRITE, “type™ DSB, operation, the 
system error recovery procedure erases the 
screen completely before initiating a 
retry. 


One channel command word is generated by 
GWRITE, “type” DSB: the Write Display Sta- 
tion Buffer Storage CCW, which initiates 
the write operation. 


DSBW_ (Write Display Station Buffer Storage 


Without Keyboard Restore): The operation 
caused by this “type™ operand, which can 


only be used with IBM 2848 Models 21 and 
22, is identical to DSB, except that the 
keyboard remains mechanically locked out at 
the completion of the operation. 


One channel command word is generated by 
GWRITE, “type™ DSBW: the Write Display 
Station Buffer Storage Without Keyboard 
Restore CCW, which initiates the write 
operation. 


EBW (Erase and Write Display Station Buffer 
Storage): This “type"™ operand causes the 


display control to delete all character 
data from the display station buffer 
storage, and to reset the cursor to the 
first display position (upper left-hand 
corner) of the CRT. The display data is 
then placed into display station buffer 
Storage, starting with the position at 
which the cursor is reset. 


Two channel command words are generated 
by GWRITE, “type" EBW. First, the Erase 
Display Station Buffer Storage CCW is 
issued to delete all character data from 
the display station buffer storage and 
reset the cursor to the first display posi- 
tion of the CRT. Second, the Write Display 
Station Buffer Storage CCW is issued to 
initiate the write operation. 


EBWW (Erase and Write Display Station Buff- 
er Storage Without Keyboard Restore): The 
operation caused by this "type" operand, 
which can only be used with the IBM 2848 
Models 21 and 22, is identical to EBW, 
except that the keyboard remains mechani- 
cally locked at the completion of the 
operation. 


Two channel command words are generated 
by GWRITE, “type” EBWW. First, the Erase 
Display Station Buffer Storage Without Key- 
board Restore CCW is issued to delete all 
character data from the display station 
buffer storage and reset the cursor to the 
first display position of the CRT. Second, 
the Write Display Station Buffer Storage 
Without Keyboard Restore CCW is issued to 
initiate the write operation. 


LNE (Write Display Station Line Address): 
This “type™ operand, which can only be used 


if the line addressing special feature is 
available, causes the display control to 
transmit sequential bytes of character data 
into the display station buffer storage 
under channel byte count control. The 
Starting location in the display station 
buffer storage, as indicated in the first 
data byte, is interpreted as a control 
byte. This byte specifies the line to 
which the display data will be transmitted 
(see Figure 6). The cursor is moved to the 
first display position of the line indi- 
cated and display data is placed into dis- 
play station buffer storage starting at the 
position of the cursor symbol. The cursor 
is automatically advanced to the next dis- 
play position. 


LNE performs essentially the same opera- 
tion as DSB. The basic difference is that 
information in the first data byte (a hexa- 
decimal value in the range FO through FB), 
which must be supplied by the user, speci- 
fies the line to which the display data 
will be transmitted. 


One channel command word is generated by 
GWRITE, “type™ LNE: the Write Display Sta- 
tion Line Address CCW, which initiates the 
write operation. 


LNEW (Write Display Station Line Address 


Without Keyboard Restore): The operation 
caused by this “type"™ operand, which can 


only be used with IBM 2848 Models 21 and 
22, is identical to LNE, except that the 
keyboard remains mechanically locked out at 
the completion of the operation. 


One channel command word is generated by 
GWRITE, “type" LNEW: the Write Display 
Station Line Address Without Keyboard Re- 
store CCW, which initiates the write 
operation. | 


| Bit Positions | Hex. | Selected | 
}012345 67 | Equiv. | Line | 
}----------------- }-------- {-------------- { 
11111090000 | FO | one | 
$111120001 | F1 | two [ 
{11112090010 | F2 | three | 
{11110011 | F3 | four | 
1111120100 F4 | five | 
111212120101 F5 | six | 
}171112120110(| F6 | seven | 
{11110111 | F7 | eight | 
{11111000 | F8 [ nine | 
{211111001 | F9 | ten [ 
j/21111010( FA | eleven { 
}/11121231011 | FB | twelve [ 
bie oe Be ea J 
Figure 6. Format of first data byte for 


line addressing operations 
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EWL (Erase and Write Display Station Line 
Address): This “type™ operand, which can 
be used only if the line addressing special 
feature is available, causes the display 
control to delete all character data from 
the display station buffer storage, and 
resets the cursor to the first display 
position (upper left-hand corner) of the 
CRT. 
play position of the specified line, and 
the display data is placed into the display 
Station buffer storage starting at the 
position of the cursor symbol. The cursor 
is automatically advanced to the next dis- 
play position. 


EWL executes the same operation as LNE, 
except that an erase operation is performed 
first. 


Two channel command words are generated 
by GWRITE, “type" EWL. First, the Erase 
Display Station Buffer Storage CCW is 
issued to delete all character data from 
the display station buffer storage and 
reset the cursor symbol. Second, the Write 
Display Station Line Address CCW is issued 
to initiate the write operation. 


EWLW (Erase and Write Display Station Line 


Address Without Keyboard Restore): The 
operation caused by this “type™ operand, 


which can only be used with the IBM 2848 
Models 21 and 22, is identical to EWL, 
except that the keyboard remains mechani- 
cally locked at the completion of the 
operation. 


Two channel command words are generated 
by GWRITE, “type” EWLW. First, the Erase 
Display Station Buffer Storage Without Key- 
board Restore CCW is issued to delete all 
character data from the display station 
buffer storage and reset the cursor symbol. 
Second, the Write Display Station Line 
Address Without Keyboard Restore CCW is 
issued to initiate the write operation. 


ERROR CONDITIONS: A normal completion is 
indicated by a hexadecimal code of 7F in 
the high order byte of the ECB (byte 0). 
If a permanent error occurs, a hexadecimal 
code of 41 is posted in this byte. 


After execution of the macro instruc- 
tion, the program should check the hexadec- 
imal return code in register 15 to 
determine whether execution was successful. 
Return codes and their meanings are: 


Return Code Meaning 
00 Normal 
10 DCB address is not in the DECB 
14 DCB addresses in the DECB and 


the IOB are not equal 
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The cursor is moved to the first dis- 


ic Type code is not in the DECB 

24 Area address is not in the 
DECB 

28 DCB addresses in the DECB and 

| the DEB are not equal 

2C Unit index in the DECB exceeds 
units specified in the DD 
record 

3C Length in the DECB is negative 


Write-to-programmer messages are issued 
for the error conditions. For message 
explanations and programmer error checks, 
see OS/VS Problem Determination Aids and 


Messages and Codes for GPS and GSP. 


EXAMPLES: In the following examples, a 
DECB named DECB1 is to be generated as part 
of the macro expansion. The “type” operand 
specifies a DSB operation for the data set 
associated with the data control block OUT- 
DCB. One hundred bytes of data will be 
written from an area in main storage called 
OUTAREA. The value of the “unit” operand 
is 1. In Example 1, L-form is specified to 
generate the parameter list. Example 2 
shows coding for an L-form GWRITE macro 
instruction when positional operands are 
omitted. Example 3 shows coding for an 
E-form GWRITE macro instruction with the 
length changed to 150 bytes. 


EXAMP1 GWRITE DECB1 , DSB, OUTDCB,100, 


OUTAREA, 1, MF=L 


EXAMP2 GWRITE DECB1, DSB, MF=L 


EXAMP3 GWRITE DECB1,,,150,MF=E 


Register Notation: The programmer may 
specify register notation. The address of 
the DECB must be loaded into register 1 
before execution of the macro instruction. 
Other positional operands may be loaded 
into other registers (2-12). For example: 


EXAMP1 LA 1,DECB1 
GWRITE (1) ,MF=E 

or 

EXAMP2 LA 1,DECB1 
LA 2, OUTDCB 
LA 3,OUTAREA 


When expressing the "unit" operand in 
register notation, the value loaded into 
the register is the same as the UCB index 
(unit-1), and is placed in the high-order 
byte of the register. 


GCNTRL -- Erase Display Station Buffer 
Storage Macro Instruction 


The GCNTRL macro instruction erases data 
from the display station buffer storage. | 
There are two possible erase operations 
performed by the GCNTRL macro instruction 
depending upon the “type™ operand speci- 
fied. The format of the GCNTRL macro 
instruction iss 


Se a de 
(kame j Operation|Operand | 


{|decb name | 
| ,type | 
| {| ,dcb address | 
| [C, unit] | 
| | (,MF={L| E}] [ 
4 L 


decb name 
is the name assigned to the data event 
control block. This operand is re- 
quired for macro expansion. 


type 
specifies the type of control opera- 
tion. This operand is required for 
proper macro expansion. The following 
are the valid forms of the operand 
(each "type" is described following 
the discussion of ail other operands 
related to the GCNTRL macro in- 
struction): 


ERS 
Erase Display Station Buffer Storage 
for the 2260. 

ERSW 
Erase Display Station Buffer Storage 
Without Keyboard Restore for the 2260. 


dcb address 
is the address of the data control 
block associated with the graphic 
device. 


unit 
is a decimal integer; it is used to 
create an index to the desired element 
in the DEB table (address pointers to 
UCBs associated with the DCB). The 
indicated UCB contains the address of 
the desired device. The vaiue of 
"unit" must be in the range 1 to N, 
where N is the number of devices spe- 
cified on the data definition card for 
this data set. WN cannot exceed 25 
(the maximum configuration is 24 dis- 
play stations and one 1053 Printer per 
display control). 


Note: The device indicated by the 
"unit" operand cannot be the 1053 
printer, Since an erase operation is 
invalid for the 1053 printer. 


Omission of the “unit” operand 
results in a value of one being 
assigned to “unit", indicating the 
first element in the DEB table. If 
*unit"® is incorrectly specified, an 
error message is printed on the 
assembly listing. 


MF= 
specifies that expansion of the macro 
instruction is to consist of a parame- 
ter list only. The name assigned to 
the parameter list is the name speci- 
fied by the “decb name" operand of 
this GCNTRL L-form macro instruction. 


MFEF= 

specifies the macro instruction is to 
perform the erase function using a pa- 
rameter list constructed by another 
GCNTRL macro instruction. The first 
operand in the E-form macro instruc- 
tion must correspond exactiy to the 
name of the parameter list. The pa- 
rameter list may be updated at execu- 
tion time by specifying new values in 
any of the operands preceding the key- 
word operand. 


A "type" operand, specified in a I-form 
macro instruction, may be modified by a 
corresponding E-form macro instruction. 
Other operands required for execution that 
were not specified in an L-form macro 
instruction should be specified in the 
corresponding E-form macro instruction. 


Note: If neither the MF=L nor MF=E keyword 
operand is written, all required operands 
must be coded to achieve executable macro 
expansion. Omission of the “decb name" 
operand prevents macro expansion; omission 
of other operands produce error messages on 
the assembly listing, but do not terminate 
macro expansion. 


TYPES OF CONTROL OPERATIONS: The two types 
of control operations for the 2260 are 
described below. 


ERS (Erase Display Station Buffer Storage): 
This “type” operand causes the display sta- 


tion to delete all character data from the 
display station buffer storage. The cursor 
symbol is placed in the first display posi- 
tion of the CRT (upper left-hand corner), 
and the remainder of the display is blank. 


GCNTRL, “type” ERS, generates one chan- 
nel command word, the Erase Display Station 
Buffer Storage Control CCW, which initiates 
the erase operation. 


ERSW (Erase Display Station Buffer Storage 


Without Keyboard Restore): The operation 
caused by this “type” operand, which can 


only be used with IBM 2848 Models 21 and 
22, is identical to ERS, except that the 
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keyboard remains mechanically locked out at 
the completion of the operation. | 


One channel command word is generated by 
GCNTRL, “type“ ERSW: the Erase Display 
Station Buffer Storage Control Without Key- 
board Restore CCW, which initiates the 
erase operation. 


ERROR CONDITIONS: A normal completion is 
indicated by a hexadecimal code of 7F in 
the high order byte of the ECB (byte 0). 
If a permanent error occurs, a hexadecimal 
code of 41 is posted in this byte. 


After execution of the macro instruc- 
tion, the program should check the hexadec- 
imal return code in register 15 to 
determine whether execution was successful. 
Return codes and their meanings are: 


Return Code Meaning 

00 Normal 

10 DCB address is not in the DECB 

14 DCB addresses in the DECB and 
the IOB are not equal 

ic Type code is not in the DECB 

24 Area address is not in the 
DECB 

28 UCB addresses in the DECB ana 
the DEB are not equal 

2C Unit index in the DECB exceeds 
units specified in the DD 
record 


Write-to-programmer messages are issued 
for the error conditions. For message 
explanations and programmer error checks, 
see OS/VS Problem Determination Aids and 


Messages and Codes for GPS and GSP. 


EXAMPLES: In the coding below, a DECB 
named DECB1 is to be addressed. The “type" 
operand specifies that an ERS operation for 
the data set associated with the data con- 
trol block OUTDCB will be performed. The 
value of the “unit™ operand is one. L-form 
is specified in Example 1. Example 2 shows 
coding for an L-form GCNTRL macro instruc- 
tion when positional operands are omitted. 
Example 3 shows coding for an E-form GCNTRL 
macro instruction when a positional operand 
is changed. 
EXAMP1 GCNTRL DECB1, ERS, OUTDCB,1, 
MF=L 


EXAMP2 GCNTRL DECB1 , ERS ,MF=L 


EXAMP3 GCNTRL DECB1,,,4,MF=E 
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Register Notation: The programmer may 
specify register notation. In such cases, 
he must load the address of the DECB into 
register 1 before execution of the macro 
instruction. Other positional operands may 
be loaded into other registers (2-12). For 
example: 


EXAMP1 LA 1,DECB1 
GCNTRL (1),MF=E 
or 
EXAMP2 LA 1,DECB1 
LA 2,4 
SLL 2,24 
GCNTRL (1) 9¢,(2),MF=E 


When expressing the “unit™ operand in 
register notation, the value loaded into 
the register is the same as the UCB index 
(unit-1), and is placed in the high-order 
byte of the register. 


WAIT -- Wait for One or More Events 


The WAIT macro instruction relinquishes 
control of the CPU when the problem program 
has no further processing to do and must 
wait for the completion of one or more 
input/output operations. For a complete 
description of the WAIT macro instruction, 


see OS/VS Supervisor Services and Macro 


Instructions. 

Rt et rr Re ie ee a eet eee 1 
| Name | O(peration| Operand | 
---------+-------—--+-------—----- ----------- 
{| symbol] |WAIT | (number of events, ] [ 
| | | Sete etaiese \ | 
| | | \ECBLIST=address | 
Reyes i) GunERL OnE mE Mee MER! en Manne ene ace en mr cet nen emery | 


number of events 
maximum is 255. Zero is an effective 
NOP instruction; one is assumed if the 
operand is omitted. The number of 
events must not exceed the number of 
event control blocks. 


ECB= 
is the address of the event control 
block representing the single event 
that must occur before processing can 
continue. Valid only if the number of 
events is one or is omitted. 


ECBLIST= 
is the address of a main storage area 
containing one or more consecutive 
fullwords on a fullword boundary. 
Each fullword contains the address of 
an event control block; the high-order 
bit in the last word must be set to 
one to indicate the end of the list. 
The number of event control blocks 
must be equal to or more than the 
specified number of events. 


CLOSE -- Close Data Control Block Macro 
Instruction 


The CLOSE macro instruction disasso- 
Ciates one or more data control blocks from 
the application program, thereby breaking 
the communication path between the applica- 
tion program and the display station. 

CLOSE performs the following functions: 


e Indicates that the DCB for the display 
station is “closed" by setting the 
appropriate bit in the DCB. 


e Releases main storage acquired at open 
time, including the chain of IOBs and 
associated channel programs, as well as 
storage acquired for attention handling 
functions. 


e Clears the fields in the DCB initial- 
ized at open time. 


e Deletes attention routines loaded by 
the “open" functions. (Basic attention 
handling only) 


e Removes entries from the DCB address 
list (poll list) constructed at open 
time. (Express attention handling 
only) 


The format of the CLOSE macro instruc- 
tion is: 


Siac eta Dre ep eee eet eae ee ey er nen 1 
| Ope ration|Operand | 


+ 
dcb address | 
7,acb address]...) | 
| 
| 


oon en tae 


| 

{ (,MF={L| (E, parameter 
{| list name) | (CE, (1))}] 
4 


dcb address 
Specifies the addresses of the DCBs 
for the graphic device(s) being 
closed. Any number of DCB addresses 
may be specified. If more than one 
DCB address is specified, the “dcb 
address™ operands must be separated by 
two commas. The second comma indi- 
cates omission of an optional operand 
not applicable to graphic programming 
services. 


MF=L 
Specifies that expansion of the macro 
instruction is to consist of a parame- 
ter list only. The name assigned to 
the parameter list is the name speci- 
fied in the Name field of this CLOSE 
macro instruction. 


MF=(E, parameter list name) 
specifies that the macro instruction 
is to perform the close functions 
uSing a parameter list constructed by 


another CLOSE macro instruction. The 
close function is executed for each 
"“dcb address" operand in the list. 
“Parameter list name" must correspond 
exactly to the name specified in the 
Name field of the CLOSE macro instruc- 
tion used to construct the parameter 
list. 


MF=(E, (1)) 
performs the same function as (E, 
parameter list name). By writing the 
special register notation (1), the 
programmer signifies that he will load 
the address of the parameter list into 
register 1 before macro instruction 
execution. 


PROGRAMMING NOTES: If a task attempts to 
close a DCB that was not opened within the 
same task, the task is abnormally 
terminated. 


If the “dcb address“ operand specifies a 
DCB that was already closed, no action 
results. If the operand does not specify 
the address of a DCB, the task is abnormal- 
ly terminated. 


MODIFYING THE DECB DURING EXECUTION 


Required parameters in the DECB may be 
modified during execution by using an E- 
form macro instruction. The following pro- 
gramming considerations apply: 


1. Register notation may be specified. 
The register is loaded with the appro- 
priate parameter before execution of 
the macro instruction. 


2. In using register notation, registers 
2 through 12 may be used for operands 
other than the “decb name" operand. 
For this operand, register 1 must be 
used. 


3. If the “type” operand is changed, it 
should be specified only by using an 
E-form macro instruction containing 
the new "type" code. Register nota- 
tion is not allowed for the "type" 
operand. 


Upon completion of an input/output 
operation, the completion flag in the event 
control block is set to one. If an ECB is 
used for more than one input/output opera- 
tion, it is the application programmer's 
responsibility to set the completion flag 
to zero before execution of the second 
input/output operation and all subsequent 
input/output operations that refer to that 
ECB. The following illustration shows the 
position of the completion flag in the ECB. 
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CP RD CRS ae em ee amie 


bits 0 1 2 © 31 


Assume, for example, that a data event 
control block named DECB1 is to be used for 
two read operations. The second GREAD 
macro instruction can be preceded by the 
following line of code to clear the comple- 
tion flag in the ECB. 


NI DECB1,X‘BF* 


OS/VS2 CONSIDERATIONS 


The following rules apply to the use of 
input/output macro instructions in a VS2 
environment, where basic attention handling 
facilities are used. 


® A graphic device that has been opened 


by one task must be closed by the same 
task. Any task attempting to open or 
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close a device that has been opened by 
another task, and not subsequently 
closed, will be abnormally terminated. 
(Note that this applies to the graphic 
device, not the DCB.) 


Within a single task, a graphic device 
may be opened more than once in succes- 
Sion (that is, without being closed 
after each open). A different DCB must 
be used each time, however. 


A task may issue input/output macro 
instructions (GREAD, GWRITE, GCNTRL) 
for a DCB that has been opened by a 
subtask or by an originating task. 
However, if the task that opened the 
DCB closes the DCB before the input/ 
output function is completed, the task 
issuing the input/output macro instruc- 
tion may be abnormally terminated. 
Synchronization of open, close, and 
input/output functions is the applica- 
tion programmer's responsibility. 


The operator at the 2260 display station 
can present information to the system 
through a keyboard. Input from the key- 
board results in an attention (an unsched- 
uled input/output interruption). In order 
for such input to be meaningful, there must 
exist a routine or routines to be entered 
when an attention occurs. 


Under basic attention handling, the 
Input/Output Supervisor automatically 
detects the occurrence of an attention and 
routes control through control routines to 
the correct application program routine. 
The application programmer must supply 
information specifying which routine is 
available to handle an attention from a 
particular display station. The macro 
instructions described in this section pro- 
vide the necessary communication between 
the application program and the Input/ 
Output Supervisor. These macro instruc- 
tions give the programmer a high degree of 
control over the attention handling 
mechanism. The macro instructions and 
their functions are listed in Figure 7. 


FUNCTIONS OF BASIC ATTENTION HANDLING 


Basic attention handling provides the 
facilities to: 


e Detect the occurrence of attentions 
automatically. 


e Route these attentions to the applica- 
tion program attention handling 
routines. 


e Queue succeeding attentions, if neces- 
Sary, until the specified routine is 
ready to process them. 


BASIC ATTENTION HANDLING 


e Wait for expected attentions, optional- 
ly continuing selective processing in 
the meantime. 


Particular advantages of basic attention 
handling are: 


e Attentions are not lost if the routine 
designed to handle them is responding 
to an earlier attention at the time 
they are received. 


e Processing may be overlapped with 
attention input or operator response 
time or both. 


e System overhead is reduced, since there 
is no need to continually check for 
attentions. 


BACKGROUND INFORMATION 


The depression of the ENTER key ona 
2260 keyboard causes the control program to 
interrupt the currently processing routine 
(which may be an attention routine) and to 
determine which, if any, routine has been 
specified to handle attentions from that 
device. If an attention routine has not 
been specified, the attention data is lost 
and control returns to the application pro- 
gram. If an attention routine is avail- 
able, the attention data is placed in the 
programmer-specified area (COMAREA), and 
the attention routine is given control. To 
be available for entry upon receipt of a 
2260 attention, a routine must have been 
designated by a SAEC macro instruction and 
the associated GACB must have been speci- 
fied by a SPAR macro instruction and not 
subsequently deleted by a DAR macro 
instruction. If the routine specified to 


nas Be ee ee ee Be ee ete ee ae ee ee nee ee pe eee ee 1 
| Mnemonic | Macro Instruction Name | Function | 
~-~---——-—} -------- ---- += == === $= === =f 22-2 
| SAEC | Specify Asynchronous Entry | Defines an attention handling routine and | 
[ | Conditions specifies the exact conditions that will | 
| | | cause entry to the routine. i 

--------— 4----—----------—--—--—-—------- + -} —- - - --- - -- - -- - - 
{| SPAR | Specify Attention Routine | Makes attention handling routines available | 
| | | for system use. | 
pierre 5 ase gaa A Ee Sa RE wae? 8 tee ee ee ai 4 
{| DAR {| Delete Attention Routine | Makes attention handling routines unavail- { 
| | | able for system use. | 

mS as 1a ee ee ee ee ee ey 
| ATTNINQ | Attention Inquiry {| Allows communication between an attention { 
| | { handling routine and the control program. | 
| En ean are Re vee a al ae aaah ls ace ie fen aah a ea ee aes Ba i a a a i Se a ca as he aso ss ms st nae Sls ans Sl Si as ca a a a lS J 


Figure 7. Basic attention handling macro 


instructions 
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process the attention is the routine in 
control, the attention data is held until 
the current processing is completed. 


Notes: Issuing an attention from a 2260 
causes the keyboard on that 2260 to become 
inoperative until the attention is pro- 
cessed either by an attention routine or by 
an ATTNINQ macro instruction. A GREAD or a 
GWRITE (not DATA ENTRY) macro instruction 
must be used to make the keyboard 
operative. 


BASIC ATTENTION HANDLING MACRO INSTRUCTIONS 


Macro instructions in this group allow 
the application programmer to define his 
program's attention handling capability to 
the system. The programmer can designate 
one attention handling routine to service 
attentions from all the graphic devices 
engaged in a task, or he can provide separ- 
ate routines for individual devices. The 
SAEC, SPAR, and DAR macro instructions are 
used to establish the status of his atten- 
tion handling routines. The ATTNINQ macro 
instruction is used to select an attention 
from a specified display station. 


SAEC -~ Specify Asynchronous Entry 
Conditions Macro Instruction 


The SAEC macro instruction defines an 
attention handling routine by creating a 
parameter list called a graphic attention 
control block (GACB). The GACB contains 
information that identifies the attention 
handling routine, relates it to a 2260, 
specifies the entry point of the routine, 
and specifies the type or types of atten- 
tions that are to cause entry to the rou- 
tine. The GACB can be referred to subse- 
quently by the symbolic name of the SAEC 
macro instruction. The format of the SAEC 
macro instruction iss: 


fe rae 5 ie aaa A ac aa a cae 1 
!Operation{Operand | 


$ + 
isymbol1] | SAEC | (BP=fentry point address |0}] | 

j | {,DCB=dcb address] | 
| | {,COMAREA=communication area address] | 
| | (, ATTNTYP={ ({A|S|R}, 2260) |SAVE] RESTORE} ] | 
| { (,mMF={L|(E, gacb address) }] | 
foe eee I i eh le a eS ts i ct ea J 


eC ET ROUT TIS LR URS 


Specifies the entry point of an atten- 
tion handling routine. If this 
operand is omitted or specified equal 
to zero (these are equivalent), any 
attention for the routine will be held 
but not processed, until such time as 
an entry point is supplied or until 
the attention is examined by the ATT- 
NINQ macro instruction. Subsequent 
attentions for this routine received 
from other 2260 stations are held 
until the first attention is 
processed. | 
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Note: The 2848 display control locks 
the keyboard on the 2260 until the 
pending attention from that device is 
processed. 


DCB= 
specifies the address of a DCB asso- 
ciated with the display station, or 
group of display stations, from which 
attentions are to be serviced. 


COMAREA= 
specifies the address of a programmer- 
defined area in main storage, aligned 
on a fullword boundary and at least 16 
bytes long, which is to be used by the 
control program to pass attention 
information to the attention routine. 


ATINTYP= 
specifies the type of attention that 
will cause entry to the attention 
routine. 


A, S, or R 
specify, respectively, whether the 
information that follows is to be 
added to or subtracted from or is to 
replace the existing ATTNTYP field in 
the GACB. If this operand is omitted 
from an E-form of the macro instruc- 
tion, R is assumed. 

2260 
specifies that the routine is to ser- 
vice attentions originating from a 
2260. 

SAVE, RESTORE 
specify, respectively, that the con- 
tents of the ATTNTYP field of the GACB 
are to be stored or are to be replaced 
with the mask saved by a previous SAEC 
macro instruction with an ATTNTYP=SAVE 
operand. 


Note: The codes A, S, R, SAVE, and 
RESTORE are provided for compatibility 
with other graphic devices, which may 
allow for more than one type of 
attention. 


MF= 
specifies that the macro instruction 
is to construct a GACB utilizing the 
specified operands. Operands omitted 
from the L-form cause the associated 
fields to be set to zeros. If neither 
the L- nor E-form is specified, L is 
assumed. A, S, R, SAVE, and RESTORE 
are not relevant when the L-form of 
this macro instruction is used. Omis- 
sion of the A, S, or R operand need 
not be indicated with a comma. 


MEF=E 
causes the GACB established by an L- 
form of this macro instruction to be 
modified, aS indicated by the other 
operands. If an operand is omitted, 


the corresponding field of the GACB is 
not affected. A comma must show the 
omission of the A, S, or R operand. 


PROGRAMMING NOTES: The vaiues specified 
for the COMAREA, DCB, ATTINTYP, and EP 
operands of the SAEC macro instruction are 
inserted in the first, second, fourth, and 
fifth words of the GACB, respectively. All 
should have been defined and the DCB must 
have been opened before a SPAR macro 
instruction referring to this GACB is 
issued. 


The GACB, created by the SAEC macro 
instruction, is 14 words long. The first 5 
words of the GACB have the following 
format : 


ne ae co er et 
a eeeagge ee 1 

a ae 

io, Gane ae 

116) EP address 


By setting the EP field of the GACB 
equal to zero, the programmer may queue 
attention data and process it in a back- 
ground routine (as opposed to an attention 
handling routine). All attention data for 
GACBs with zero EP fields is placed on the 
Same queue. The attention data may be 
accessed when desired by means of the ATT- 
NINQ macro instruction. 


The EP field may be set to zero at 
assembly time (by means of the SAEC macro 
instruction) or at any time during execu- 
tion. If it is set to zero at execution 
time, any attentions received prior to set- 
ting EP equal to zero will be processed as 
described under “Background Information"; 
any received after EP has been set to zero 
will be queued. 


The first four words of the COMAREA have 
the following format: 


comarza +of ix | RESERVED | ZYPE | 
— ‘aaa: °C : 

F nn “=. °°" ' 

7 oo 


Field 
RESERVED 


Contents 
These fields are us27% 
trol program. 


Yue 
bee 


the con- 


Ix If multiple 2260s are assigned to 
a Single DCB, this byte is set to 
an integer from 1 through 25 to 
indicate which device originated 
the attention that the routine 
has currently available for pro- 
cessing. The value of IX corre- 
sponds to the position of the 
device in the device list sup- 
plied by the DD card and placed 
in the DEB by an OPEN macro 
instruction. (IX functions in 
the same manner as the “unit" 
operand of the GREAD, GWRITE, and 
GCNTRL macro instructions.) If 
one 2260 is assigned to a single 
DCB, the byte is set to zero 
(hexadecimal 00). 

TYPE This is always a hexadecimal 07, 

signifying a 2260 attention. 


The user may add other fields to the 
COMAREA; see the suggestion under “Applica- 
tion Program Attention Handling Routine.* 


If an attention routine is to serve more 
than one device, and these devices have 
been specified in separate SAEC macro 
instructions, its executable code must be 
reenterable. 


The DCB address in a GACB should not ke 
changed without first deleting the atten- 
tion routine with a DAR macro instruction. 
After changing the DCB address, the routine 
must be respecified with a SPAR macro 
instruction. 


EXAMPLES : 


GACBX1 SAEC EP=AR1, DCB=GRAPHD1, 
ATTNTYP= 2260, 
COMAREA=AREA1 


The GACB established by this macro 
instruction can be referred to by the sym- 
bol GACBX1. The GACB defines an attention 
routine whose entry point is AR1. This 
routine is able to service attentions from 
the 2260 display station or stations asso- 
ciated with the identified DCB, and it will 
receive attention information in the COM- 
AREA identified by the symbol AREA1. 
Because the macro-form (MF) is not speci- 
fied, L-form is assumed. 


EX2 SAEC DCB=GRPHDCB2,EP=(3), 
MF= (E, GACBX1) 


This macro instruction changes the DCB 
address and the attention routine entry 
point in the GACB defined in the first 
example. 
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“Note: If this routine has been previously 
specified (with a SPAR macro instruction), 
it must be deleted (with a DAR macro 
instruction) before changing the DCB 
address. After issuing the SAEC macro 
instruction to change the DCB address, the 
attention routine must then be respecified 
before it is available to the system. 


SPAR -- Specify Attention Routine Macro 
Instruction 


The SPAR macro instruction makes pre- 
viously defined attention handling routines 
available for system use by establishing 
control program references to their GACBs. 
It also assigns priority if multiple atten- 
tion routines are defined. The format of 
the SPAR macro instruction is: 


pee pe a a ee 
| Name {| Operation | Operand 1 
BO pe teas A Se sk el ot Ne ee ee | 
| (gacb address | 
{(,gacb address]...) [ 
| | (, PRTY=integer] | 
{ {(,MF={L[(E,gacb list | 
| | address) }] | 
r J 


gacb address 
specifies the address of a graphic 
attention control block (GACB), de- 
fined by a SAEC macro instruction, 
that is to be made available to the 
System. 


PRTY= 
is a decimal integer from 0 through 
127, used to determine priority among 
attention routines. Priority in- 
creases with numeric value (127 gives 
highest priority). No attention 
handling routine may have control 
while a higher-priority routine for 
the same device has any processing to 
do. 


MF=L 
specifies the construction of a list 
of GACB addresses that can be used by 
an E-form of either a SPAR or DAR 
macro instruction. 


MP=-E 
specifies that the list of GACBs 
referred to by the “gacb list address" 
Operand is to be modified as indicated 
by the “gacb address" operands and 
that the GACBs in the list are then to 
be specified, that is, made available 
for system use. The list cannot be 
lengthened or shortened by the E-form 
of this macro instruction. 


gacb list address 2 
specifies the address of a list of 
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PROGRAMMING NOTES: 


ERROR CONDITIONS : 


GACBs established by an L-form SPAR 
macro instruction. 


The PRTY operand is 
provided primarily for compatibility with 
certain other graphic devices that are cap- 
able of originating more than one type of 
attention. For such devices, the PRTY 
operand permits a routine designed to 
handle attentions of a particular type to 
interrupt another, less important, atten- 
tion routine that handles attentions of 
another type from the same device. The 
programmer establishes the relative “impor- 
tance" of routines for this purpose by use 
of the PRTY operand. This usage is not 
possible on the 2260, which can originate 
only a single type of attention. There- 
fore, the PRTY operand can normally be 
omitted. 


When the PRTY operand is omitted, a 
priority of zero is assigned. 


If more than one attention routine is 
available for any one 2260 at any time, and 
if these routines have been assigned the 
same numeric priority (for example, by 
omission of the PRTY operand), the routine 
referred to last in the last SPAR macro 
instruction has the highest priority. 


All attention handling routines take 
precedence over any background routine. 


An attention routine may be interrupted 
and immediately reentered if the same rou- 
tine is defined in separate SPAR macro 
instructions for two or more display sta- 
tions or if the routine is used by more 
than one task. Such a routine must be 
reenterable (that is, it must not modify 
itself in any way). 


If the same GACB is referred to more 
than once in a SPAR macro instruction, 
references after the first are treated as 
no-operations. A GACB address of zero, in 
a list of GACB addresses, will also be 
treated as a no-operation. 


Certain error conditions 
will stop the processing of a list of GACBs 
and cause an immediate return. Upon return 
to the program, register 1 will contain the 
address of the GACB associated with the 
error condition, and register 15 will con- 
tain one of the following return codes to 
indicate the type of error: 


Return Code Meaning 
04 DCB is not a graphics DCB 
08 GACB was already specified 
through a SPAR macro 
instruction 


0c Parameter list is too short to 
contain GACB addresses 


10 DCB is not open 


14 (OS/VS2 only) SPAR macro 
instruction is not issued by 
the task that opened the DCB 


Write-to-programmer messages are issued 
for the error conditions. For message 
explanations and programmer error checks, 
see OS/VS Problem Determination Aids and 


Messages and Codes for GPS and GSP. 
EXAMPLES: 


EX1 SPAR (GACBX2) 

This macro instruction establishes con- 
trol references to the routine defined ina 
GACB identified by GACBX2. 

EX2 SPAR (GACBX1,NAME3,TAG6) ,MF=L 

This macro instruction constructs a list 
containing the three GACB addresses 
specified. 
EX3 SPAR (, ,GACBX3) , MF= (E, EX2) 

This macro instruction causes the paranm- 
eter list constructed by EX2 to be modi- 
fied, replacing the third GACB address 
(TAG6) with GACBX3. Control references are 
then established for the three GACBs 
referred to by the list. 


DAR -- Delete Attention Routine Macro 
Instruction 


The DAR macro instruction is the inverse 
of the SPAR macro instruction. It makes 
attention handling routines unavailable for 
system use by deleting the control program 
references to the GACBs established by 


SPAR. The format of the DAR macro instruc- 
tion is: 

IC Re Re CST Got a ie ee 1 
| Name | Operation|Operand | 


| (gacb address | 
{l,gacb address]...) | 
{C,MF={L|[(E, gacb list | 
{ address) }] | 
L 


gacb address 
specifies the address of a GACB defin- 
ing the attention handling routine to 
be deleted. 


MF= 
specifies formation of a list of the 
GACB addresses written in the macro 
instruction. 


=E 
Specifies that the list of GACBs 
referred to by the “gacb list address" 
Operand is to be modified by the "gacb 
address“ operands and that all atten- 
tion routines referred to in the list 
are then to be deleted, that is, made 
unavailabie for system use. 


gacb list address 
specifies the address of a list of 
GACB addresses constructed by an L- 
form SPAR or DAR macro instruction. 


PROGRAMMING NOTES: The CLOSE function will 
delete all attention routines defined for 
the associated DCB. However, an attempt to 
issue a CLOSE macro instruction from an 
attention routine will result in abnormal 
termination of the task. Similarly, an 
attempt to delete an active attention rou- 
tine will result in an error condition. 


ERROR CONDITIONS: Certain error conditions 
will stop the processing of a list of GACBs 
(or of one GACB) and cause an immediate 
return. Upon return to the program, 
register 1 will contain the address of the 
GACB associated with the error condition, 
and register 15 will contain a return code 
to identify the error condition as follows: 


Return Code Meaning 
O04 DCB address is not in the GACB 
08 GACB was not specified through 


a SPAR macro instruction 


0c Parameter list is too short to 
contain GACB addresses 


10 Specified attention handling 
routine is still active 


14 (OS/VS2 only) DAR macro 
instruction is not issued by 
the task that issued the SPAR 
macro instruction 


18 DCB is not open 
ic DCB is not a graphics DCB 
20 Attention handling environment 


is not basic 


Write-to-programmer messages are issued 
for the error conditions. For message 
explanations and programmer error checks, 
see OS/VS Problem Determination Aids and 


Messages and Codes for GPS and GSP. 
ATTNINQ -- Attention Inquiry Macro 


Instruction 
The ATTNINQ macro instruction estab- 


lishes communication between an attention 
handling routine and the control program to 
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permit the routine to select an attention 
from a specified display station or from 
any display station. This allows the 
attention handling routine to wait until 
the attention occurs, to relinguish control 
to the mainline program until the attention 
occurs, to branch to a specified address if 
specified attention information is pending, 
or to clear all attentions pending for this 
routine. In the case of CLEAR, the atten- 
tions are released, but the 2260 display 
Station must be manually unlatched. The 
format of the ATTNINQ macro instruction is: 


 espiaaiataamapieaas er ee erg eee re a 1 
| Name | Operation|Operand | 


jgacb address, | 
| MODE={R{W](C,branch address) |CLEAR} | 
| | {| {,UNIT={int eger | ALL} ] | 
| | | €,MF={L| (E, parameter list address) }]| 
ieee a eran pe Leeeee eee eer I a a ae eh a he J 


F + 
| (symbol) | ATTNINQ 
| | 


gacb address 
specifies the address ot the asso- 
ciated GACB. 


MODE= 
specifies one of the four modes of 
inquiry, as follows: 


R 
relinguish mode. The attention handl- 
ing reutine is to relinquish control 
until attention information from the 
display station the routine is servic- 
ing (specified by the UNIT operand) is 
available for that routine. When this 
information is available, processing 
resumes with the next sequential 
instruction. This mode is treated by 
the system as a W (wait) mode if the 
ATTNINQ macro instruction is issued 
from a routine entered by means of a 
LINK macro instruction, or if the EP 
field of an associated GACB has been 
set to zero. 


Wait mode. The attention handling 
routine is to be placed ina wait 
State until attention information is 
available from the display station 
Specified by the UNIT operand. While 
the attention routine is in a wait 
State, attentions from other display 
stations can be serviced by other 
attention routines or another task can 
be in control. When the wait condi- 
tion is satisfied, and control is 
returned to the attention routine, 
processing continues with the next 
sequential instruction. 

C, branch address 
condition mode. If attention informa- 
tion from the device specified by the 
UNIT operand is presently pending for 
processing by this attention handling 
routine, a branch is made to the loca- 
tion specified by the “branch address" 
operand. Otherwise, processing con- 
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tinues with the next sequential 
instruction. 

CLEAR | 
clear mode. All attentions pending 
for this attention handling routine 
are released, and processing continues 
with the next sequential instruction. | 
The keyboard on any 2260 display sta- 
tion must be manually unlatched if an 
attention issued by it has been 
cleared by an ATTNINQ macro 
instruction. 


UNIT=integer 
specifies a decimal integer from 1 
through 25 and corresponds to the 
position of the device in the device 
list supplied by a DD statement, where 
multiple devices are assigned to a 
Single DCB. It is used as an index to 
select one of the several UCB 
addresses appended to the data extent 
block (DEB). The index value corres- 
ponding to the 1053 printer may not be 
specified. (This operand functions in 
the same manner as the “unit™ operand 
of the GREAD and GWRITE macro 
instructions. ) 


UNIT=ALL 
Specifies that an attention will be 
accepted from any 2260 assigned to the 
DCB. 


If the UNIT operand is omitted, ALL 
is assumed. — 


MF=L 
specifies that the expansion of the 
macro instruction is to consist of a 
parameter list only. The symbol writ- 
ten in the Name field is assigned to 
the parameter list. 


=E 
causes the parameter list, established 
by the L-form of the macro instruction 
and identified by the parameter list 
address operand, to be modified by the 
preceding operands and causes the 
attention inquiry request to be 
executed. 


parameter list address 
specifies the address of a parameter 
list established by an L-form ATTNINQ 
macro instruction. 


PROGRAMMING NOTES: The ATTNINQ macro 
instruction may be issued within an atten- 
tion routine or, if the EP field of the 
associated GACB is set to zero, may be 
issued from a background routine. Standard 
register conventions must be observed. 


The UNIT operand must be used in con- 
junction with the W or C mode if there are 
multiple devices for the associated DCB. 


It is meaningless in conjunction with the 
CLEAR or R mode. 


Under R, W, or C mode, information per- 
taining to the attention that satisfies the 
inquiry is made available in the COMAREA. 


ERROR CONDITIONS: During execution, cer- 
tain error conditions will terminate pro- 
cessing of the ATTNINQ macro instruction 
and cause an immediate return to the pro- 
gram. Upon return, register 15 contains a 
return code to identify the error condition 
as follows: 


Return Code Meaning 
10 Parameter list contains no 


GACB address 


14 EP2 field of the GACB is not 
Zero 
18 GACB was not specified through 


a SPAR macro instruction 


1c (OS/VS2 only) ATTNINQ macro 
instruction is not issued by 
the task that issued the SPAR 
macro instruction 


20 Mode field in the parameter 
list is invalid 

24 Internal dequeue error 
occurred 

28 Specified attention handling 
routine is already in a wait 
state 

2C Branch address is not in the 


parameter list 


Write-to-programmer messages are issued 
for the error conditions. For message 
explanations and programmer error checks, 
see OS/VS Problem Determination Aids and 


Messages and Codes for GPS and GSP. 
EXAMPLES: 


EX1 ATTNINQ GACBX4,MODE=R 


This macro instruction causes control by 
the attention routine to be relinquished 
until the desired attention occurs. 


EX2 ATTNINQ GACBX4,MODE=W, UNIT=5 


This macro instruction causes the task 
to enter a WAIT state until attention 
information from the display station which 
occupies the fifth position on the device 
list is available. 


EX3 ATTNINQ GACBX4, MODE=(C, BRANCHA), 
UNIT=5 


This macro instruction causes a branch 
to be taken to location BRANCHA if an 
attention from the display station which 
occupies the fifth position on the devices 
list is pending. 


EX4 ATTNINQ GACBX4,MODE=CLEAR 


This macro instruction causes all atten- 
tions pending for this routine to be 
released. 


APPLICATION PROGRAM ATTENTION HANDLING 
ROUTINE 


The following notes may be helpful to an 
application programmer writing a program 
designed for operator-machine 
communication. 


Establishing the Attention Routine 


An attention handling routine is defined 
by means of a SAEC macro instruction, which 
establishes a graphic attention control 
block (GACB) containing the information 
provided in the SAEC macro instruction. In 
the GACB are: 


1. The address of the entry point of the 
associated attention routine. 


2. The address of a DCB associated with 
the device to be serviced. 


3. The address of a communication area 
(COMAREA) to be used to pass attention 
information to the attention routine. 


The GACB thus provides a link between a 
display station or group of display sta- 
tions and an attention routine. 


Although defined, an attention routine 
is not available for use until it has been 
"specified" by means of a SPAR macro 
instruction. This establishes control pro- 
gram references to it. 


The DAR macro instruction can be used to 
disable an attention routine that is no 
longer needed, although the associated DCB 
remains open. The SPAR and DAR macro 
instructions may be thought of as analogous 
to OPEN and CLOSE. 


Processing the Attention 


Upon entry to an attention handling rou- 
tine, register 1 contains the address of 
the GACB. In the first word of the GACB is 
the address of the communication area, or 
COMAREA. If more than one device is 
assigned to the DCB, the first byte of the 
COMAREA indicates the device that origina- 
ted the attention. 
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Use of the communication area allows the 
programmer to pass information between the 
housekeeping/background routine and the 
attention routine or routines. Each dis- 
play station may be associated with its own 
communication area, and the attention data 
for each display station may be recorded 
independently of that for other display 
units. One of the fields in the communica- 
tion area can be an ECB where completion of 
attention processing can be posted. The 
attention routine can post the appropriate 
ECB when it completes attention processing 
for that display station. 


Using the information available in the 
COMAREA and the DCB, the attention handling 
routine can perform necessary calculations, 
issue appropriate input/output commands, 
and do whatever else is required to respond 
to the attention. If further communication 
from the display station operator is 
required, an ATTNINOQ macro instruction can 
be used to relinquish control or enter a 
wait state until the desired attention 
occurs, or to set up a conditional branch 
based on its availability. 


When processing of the last attention of 
a communication sequence has been com- 
pleted, attentions (for this routine) can 
be cleared by means of an ATTNINQ, mode 
CLEAR, macro instruction before passing 
control to the interrupted routine by means 
of the RETURN macro instruction. 


. The following is a brief outline of 
functions that might be performed by a 
housekeeping/background routine and by an 
attention handling routine. 


Housekeeping/Background Routine 


1. Open the DCB for the display station 
or stations. 


2. Establish the attention routine by 
means of the SAEC and SPAR macro 
instructions. 

3. Issue input/output commands. 


4. Make sure that input/output operations 
were started successfully. 


5. Wait for posting of completion in the 
ECB or perform background processing, 
which may or may not be related to the 
attention routine. 

6. Close the DCB. 

7. (Indicate task completion by issuing 
the RETURN macro instruction. 
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Attention Routine 


1. Perform standard entry functions: 
save registers, establish addressabil- 
ity, etc. | 


2. Perform operations based on the atten- 
tion information. 


3. Issue input/output commands. 


4. Make sure that input/output operations 
were started successfully. 


5. Wait for the next attention by means 
of the ATTNINQ macro instruction. 


6. After the last attention is serviced, 
post completion in the ECB and return 
control to the background routine by 
means of the POST and RETURN system 
macro instructions. 


Synchronizing the Application Program 
Routines 


Synchronization of the housekeeping/ 
background routine and the attention handl- 
ing routine is the application programmer's 
responsibility. He may use the WAIT system 
macro instruction to delay execution of the 
housekeeping/background routine until com- 
pletion has been posted in an ECB by the 
application program attention routine. 
attention routine may either explicitly 
post the ECB by means of the POST system 
macro instruction or, by means of an appli- 
cation program convention, locate the 
appropriate ECB by means of the graphic 
attention control block and then post con- 
pletion. The attention routine passes con- 
trol back to the housekeeping/background 
routine by means of the RETURN macro 
instruction. Since completion has been 
posted, the housekeeping routine is taken 
out of its wait state, and execution con- 
tinues. This cycle, the passing of control 
to the attention routine when an attention 
occurs and the returning of control to the 
interrupted (housekeeping/background) rou- 
tine when completion is posted, continues 
as long as the attention routine is defined 
and as long as attentions occur. 


The 


OS/VS2 CONSIDERATIONS 


The following rules apply to the use of 
kasic attention handling facilities ina 
VS2 environment. 


In order for the application program 
attention handling routines to be 
available to a device, they must be 
defined (by means of an SAEC macro 
instruction) and specified (by a SPAR 
macro instruction) within the task that 


opens that device or within one of its 
subtasks. A SPAR macro instruction 
issued from an inappropriate task will 
return with a return code of hexadecin- 
al 14. 


Each GACB must be deleted (by means of 
DAR) by the task in which it was speci- 
fied (by SPAR). A DAR macro instruc- 
tion from another task will cause a 
return with a return code of hexadecim- 
al 14. An attempt by one task to close 
a DCB for which one or more GACBS are 
Still specified by another task will 
result in the abnormal termination of 
the specifying task. 


An ATTNINQ macro instruction for any 
GACB may be issued only by the task 
that specified (by means of SPAR) that 
GACB; otherwise, the ATTNINQ macro 
instruction returns control with a 
return code of hexadecimal 1C. 


An application program attention rou- 
tine may serve more than one task. 
However, a separate GACB must be estab- 
lished for each task-device-routine 
combination. The application programm- 
er is responsible for ensuring that the 
task containing the attention routine 
is not terminated while other tasks 
have active (currently specified) GACBs 
referring to that routine. 
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APPENDIX A: SAMPLE PROGRAN 


Coding shown in Figure 8 is intended for 
use with two IBM 2260 Display Stations 
(Local Attachment), equipped with the 
alphameric keyboard feature. A 1053 print- 
ex is not needed. 


For the purposes of this sample progran, 
it is assumed that the first seven charac- 
ters of the manual input message contain a 
code (*PROCESS') that determines whether 
the routine processes the message and 
stores the results or, in the absence of 
the code, ends the job and displays results 
derived from the processing of each indivi- 
dual request. 


The purpose of each element of the pro- 
gram is explained by the comments in the 
illustration. The following paragraphs 
note several graphic programming considera- 
tions illustrated by the program. 


Opening the DCB: The DCB for the 2260s 
must be opened before references are made 
to it. 


* 


SAMPLE PROGRAM 
ecm ed 


STATEMENT 


IBM System/360 Assembler Coding Form 


GRAPHIC cal 
eiueT Ons 
PUNCH 


Use of the GREAD Macro Instruction: The 
GREAD macro instruction shown in the coding 
generates a Read Display Station Manual 
Input (DSM) operation. 


Use of the GWRITE Macro’ Instruction: The 
GWRITE macro instruction shown issues an 
Erase and Write Display Station Buffer 
Storage (EBW) operation to clear the 
storage and write a message to the 
operator. 


Use of the Basic Attention Handling Facili- 
ties: All application program attention 


handling routines should consider then- 
selves as subroutines, and as such, stan- 
dard subroutine linkage should be observed. 
The COMAREA should be saved if there. is any 
possibility that the attention routine pre- 
sently in control may be interrupted during 
execution by another attention routine that 
shares the same COMAREA. 
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Terre LTS TTT TTT Ei TTT] TeST WHETHER PARAMETERS ACCEPTED | 
TE Hinreteeetoeces t-—— tA Wr Prep apemar(one TT 
rect | beces,.x're [| Tes where THER I/O] WAS SUCCESSFUL [| 
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Figure 8 (part 1 of 7). 


30 


Coding for sample program 
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Appendix A: 


APPENDIX B: CCW*S ASSOCIATED WITH INPUT/OUTPUT CONTROL 


The following are formats of CCWs generated when GREAD, GWRITE, and GCNTRL macro 


instructions are used. 


34 


GREAD DSM CCW FORMAT 


Command Data : Byte 
Code Address Flags* Count 


ee eg mye TT rea Ie OR, a Re NR Rie gar tee ee pe Re ee Ee ee eee ae 


02 | lf ft tE-t t | | 


en ec csp cs cea ec ep lbs se ssl ss As cael cn Sp ly ih sae Gave at ep Se ac Sc ect Gs indecent a mt ce all 


: 
| 
L 

0 7 8 31 32 33 34 35 36 48 63 


GREAD DSMW CCW FORMAT 


‘Command Data Byte 

Code Address Flags* Count 
 Saacoraireaae eee ee po te i er ee ge ern Se ere 1 
{ 12 | rf [| ¢f€— ¢€= FI | | 
I a a ac a a a ee ee aed 
0 7 8 31 #32 #33 34 #35 36 48 63 


GREAD SMI CCW FORMAT 


Command Data Byte 

Cod Address Flags* Count 
(SS ee ee 4 SMe re ee ee nn ee ne 1 
| OA | tf | | ¢ tt | | 
bes i oe H Reeeeeens Geese eran Piece Pe een eee en eae ap ree Jj 
0 7 8 31 32 33 34 35 36 48 63 


GREAD SMIW CCW FORMAT 


Command Data Byte 

Code Address Flags* Count 
er ey re gr ee ee ee i aero ee ee Sore Se ee 1 
| 1a | rf | Tt 4 | =| | | 
As eect Ba RRR, CR AnRd Seioneade! Cergienneinys (Un eSy! nase NCA em Meen nea ein tep Eee aN fae ee eee ee eae | 
0 7 8 31 32 33 34 35 36 4g 63 


GREAD DSB CCW FORMATS 


Command. Data Byte 

Code Address Flags* Count 
(Oe eee gs ees eee Ge a ee ee re er Senos 1 
| 06 | ft |2t ft ft | | 0002 | 
betes ee eee hae p eaaceate! er arhas enemies CASRN) Conaen asym a omNPnn ie pone on emer on Ye aan ne ee eiemey ee eee ee 4 
0 7 8 31 32 33 34 35 36 4g 63 
Command Data Byte 

Code Address Flags* Count 
Ge ee ee ee ee eae ee a eee ea 
| o7 | i | {1 | | | | 0002 | 
a Na ah 
0 7 8 31 32 33 34 35 36 48 63 
* 


Bit 33 -- chain command flag 
Bit 34 -- suppress length indication flag 


GREAD DSBW CCW FORMATS 


Command Data Byte 

Code Address Flags* Count 
Big ae et er Or ere ee rr re ee nee ee a ee er 
| 16 | fr itt] sf | | l | 
Oa a a oe a ee ee he ed 
0 7 8 31 32 33 34 35 36 48 63 
Command Data Byte 

Code Address Flags* Count 
ea aaanerioaas a ae SS oe Se Re a ee ee a oe Sara 
[| 17 | I tf ttt Ft | | 
ESN Peepengeen! HSER AME MY AOC een PERN! ERE eam ere Geren DMR (isn aeaere) CM are neteNe eI, Oar ees Ren CPS MULES MINS enema eee! 
0 7 8 31 32 33 34 35 36 48 63 


GWRITE DSB CCW FORMAT 


Command Data Byte 

Code Address Flags* Count 
aaa aa Me ee ee eee ree eg he ee ee i ee to ee a 1 
| 01 | fr ft ttt ft | | 
Be eA a a Pe Se bees oe Poe No eee te J 
0 7 8 31 32 33 34 35 36 48 63 


GWRITE DSBW CCW FORMAT 


Command Data Byte 

Code Address Flags* | Count 
err ag aaa Coot oS a Pe ee a ee Sma asa ie ceca | 
| 11 | cr | dit | | | | 
bee EEN Weare proto eee rin ene anne a ce ee es J 
0 7 8 31 32 33 34 35 36 4g 63 


GWRITE EBW CCW FORMATS 


Command Data Byte 

Code Address Flags* Count 

Ee ge a re ee nn a ee ee ee | 
| O7 | Pr ttyeri ft | | 0002 | 
bese ee Nc A a cs Be J 
0 7 8 31 32 33 34 35 36 4g 63 
Command Data Byte 

Code Address Flags* Count 
re ee ee ee re re pe Mei a =a 
| o1 | | | 1 | Lt | | | 
cies I fe ect Ue Me BE he ee ee ae eee a Jj 
0 7 8 31 32 33 34 35 36 48 63 

GWRITE EBWW CCW FORMATS 

Command Data Byte 

Code Address Flags* Count 
 ieaenurcaare Co ee ee ee ee 1 
| 17 | ft 4 Eat ¢[ { | 0002 | 
L ee ee ee ee ee 4. —— —— 4-——-1—__1-.-1.~ 41 i 4 
0 7 8 31 32 33 34 35 36 48 63 
Command Data Byte 

Code Address Flags* Count 
Am maa aaa aca amy as a aa a a aaa a aaa aaa 1 
{[ 11 | fr tf ttt ft 1 | | 
Oa a a ed 
0 7 8 31 32 33 34 35 36 ug 63 
* 


Bit 33 -- chain command flag 
Bit 34 -- suppress length indication flag 
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GWRITE LNE CCW FORMAT 


Command Data | Byte 

Code Address Flags* | Count 
a ee rr er a ne ee 
[| Oo | tt F— Ttt ¢ I | — | 
Oe Se a et eG ee 
0 7 8 31 32 33 34 #35 36 48 63 

GWRITE LNEW CCW FORMAT 

Command Data Byte 

Code Address | Flags* Count 
TT eT nn nnd) 
[| 15 | cf ft Tat t | | | 
EER eee AEE P NT EEN (RENTON SRR OEN MRPREMANT! Het ests Seg ney yes eens RN es may eee Corea NSSRMe ree ee Raeet eRe AmE NE 
0 7 8 31 32 33 34 35 36 4g 63 


GWRITE EWL CCW FORMATS 


Command Data Byte 

Code Address Flags* Count 
ere Re Bree eee eg om ee et en ee 
{| o7 | | ~2rtrt | F | 0002 | 
beeper a eee B cercoe ts Snr: Leimersie Kear Cine Rnoeay! bess ieee ipmamyrerrin ee eee ae em hs sa otra eres tt 
0 7 8 31 32 33 34 35 36 48 63 
Command Data | Byte 

Code Address Flags* Count 

Fe ta rg cee ee ee ere ee ee Ny rN Cr ee Re eee a Cg Se eee ea 
| oO | | $$ T2ttl ¢ | | 
a a ee te es a ek a ee i ee 
0 7 8 31 32 33 34 35 36 48 63 

GWRITE EWLW CCW FORMATS 
Command Data | Byte 
Code Address | Flags* Count 

tes rn ee eee ee ee Mic ie es 1 
[| 17 | f 12 Pat | | | 0002 | 
epee pea Sa it a a aS Me Nal 
0 7 8 31 32 33 34 35 36 48 63 
Command Data , | Byte 

code Address Flags* Count 

Berge Seana ani area PM a ee ee ea ee ee ef ee a ee 
| is | tf tf E242 | | | | 
Eee ane meer UMNrEn eee Maen ep Eire aN I I a i re el sae J 
0 7 8 31 32 33 34 35 36 | 4g 63 

GCNTRL ERS CCW FORMAT 
Command Data Byte 

Code Address Flags* | Count 
Co be Coe ar ee ee ee eee 
i o7 | if | fat ¢ | | 0002 | 
a a a eh al 
0 7 8 31 32 33 34 35 36 | | 48 63 

GCNTRL ERSW CCW FORMAT 
Command Data | Byte. 

Code Address Flags* Count 
 eciirearice See ee ee es Re Ree ee ee ee ee ee 
| 17 | tf | Eid @¢sf | 0002 | 
a a a i a Aca aI a le ae as i a a cae ares cee ee ie ae eee tae eal etians Soe 
0 7 8 31 32 33 34 35 36 48 63 

Ss 


Bit 33 -- chain command flag 
Bit 34 -- suppress length indication flag 


The operator at the 2260 display station 
can present information to the system 
through a keyboard. Keyboard input results 
in an attention interruption. Express 
attention handling requires that the appli- 
cation program check for the occurrence of 
an attention. When an attention is 
detected, attention information is routed 
to the appropriate application program 
attention handling routine. 


Macro instructions are provided to com- 
municate the occurrence of attentions to 
the application program. The macro 
instructions and their functions are listed 
in Figure 9. 


BACKGROUND INFORMATION 


When an attention from a 2260 occurs, 
the application program is interrupted and 
control goes to the control program. The 
control program sets a bit in the graphic 
control byte (GCB) associated with the dis- 
play unit from which the attention was 
received. Control then returns to the app- 
lication program at the point of 
interruption. 


To determine whether or not an attention 
has occurred, the application program must 
include an attention analySis provision to 
periodically inspect the bits in the GCBs. 
This attention analysis can be done by 
using either the ANALYZ macro instruction 
Or a programmer-written substitute. If the 
application programmer elects to perform 
his own attention analysis, he must employ 
the GSERV macro instruction to reset bits 


APPENDIX C: EXPRESS ATTENTION HANDLING 


EXPRESS ATTENTION HANDLING MACRO 


INSTRUCTIONS 


The macro instructions in this group are 
provided to help the application programmer 
service attentions from the 2260. 


ANALYZ -- Graphic Attention Analysis Macro 
Instruction 


The ANALYZ macro instruction performs 
attention analysis to determine the occur- 
rence of and the reason for an attention 
from a keyboard entry on the 2260. This is 
done by a polling technique that inspects 
the bits in the GCBs. The ANALYZ macro in- 
struction also resets the GCB (by calling 
on the GSERV macro instruction), places 
coded information into an output area 
defined by the application programmer, and 
gives control to the appropriate applica- 
tion program routine to handle the 
attention. 


To employ the ANALYZ macro instruction, 
the application programmer must: 


1. Include the ANALYZ macro instruction 
statement in his application program. 


2. Provide a contiguous list of DCB 
addresses and UCB index factors that 
indicate the UCB containing the appro- 
priate GCB from which an attention is 
possible. This list is provided at 
open time if the POLST operand is spe- 
cified in the DCB macro instruction. 


3. Specify the entry address of the rou- 
tine to handle the keyboard attention. — 


4. Reserve eight bytes (beginning on a 
fullword boundary) in his program area 
into which the output of ANALYZ can be 


in the GCBs. placed. 

Ce ee i, ao cea Rr ee eg ee ee ee ee Fe ap eee ee ee oe 1 
| | Macro Instruction | | 
| Mnemonic | Name | Function { 
Ss =— | gems aac aR OR aS eS RSG SSSA grag aT EE ee | 
| ANALYZ | Graphic Attention | Determines and analyzes the occurrence of an atten- | 
| {| Analysis {| tion from a display station. The bits in the GCB | 
| ; | are reset before control is given to an application | 
| | | program routine to handle the attention. | 
;--------- See gee ee ee ee ee De ee eee tee 4-~—-—-------—--—--—-—-—-—~—-—-- —-—- + = Se ee ee ee a 4 
| GSERV | Graphic Attention | Resets the bits in the GCBs associated with atten- | 
| | Service | tions. This macro instruction must be employed if [ 
| | | an application programmer elects to perform his own | 
| ; | attention analysis instead of using ANALYZ. | 
eee nen eee ee a Cape eee ee a ee PO SRS re ESE Oca ea aha aaa ee gt a eee ea ae a el lees r) 


Figure 9. 


Express attention handling macro instructions 
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The format of the ANALYZ macro instruction 
is: 


‘ae Me es ee 1 
| Operation | Operand 


ool one 


j (symbol] | ANALYZ |polst address, | 
i { {pointer address ] 
| { j/{,MF={L| (E,parameter | 
i | {| list name) | (E, (n))}] | 


Loe ene NY (CANE ee eed Le Ree eee eran See ee eer een 


polst address 

is the address of a four~-byte reserved 
area followed by a list of DCB 
addresses and UCB index factors that 
indicate the UCR containing the appro- 
priate GCB. Each is aligned on a ful- 
lword boundary. The reserved area is 
used by ANALYZ to point to the last 
DCB address in the list. The list is 
constructed at open time if the POLST 
operand is specified in the DCB macro 
instruction. The format of the list 
is: 


Se our 4 
{UCB i DCB | 
jindex | Address | 
}------}---------—-----------4 
jUCB | DCB | 
{Index | Address | 
--——--—~ L-—. -—- ~~ —----—-—-~-~--—— 


Pee tee ere 


pointer address 

is the symbolic address of the first 
word of a five-word field located ona 
fullword boundary in the application 
program area. The contents of the 
fieid are shown in Figure 10. 


Note: The application programmer must 
insert zeros in three of the five words 
indicated in Figure 10. Word two of the 
pointer table must contain a valid routine 
address if either optional keyboard feature 
is used. 


Re A eR Nak eR: Se i Sea SO OR AE SSS ES RS Se, ee Se ae ener See See eee ee ae ae Se eae a ee ae a | 

| Word | Contents [ 
}------ f--~-------~----------------------- { 
j 1 {| (Not used. Programmer must spe- | 
| | cify zeros.) | 
| 2 |; Address of the application pro- | 
i | gram Keyboard Attention routine. | 
{ 3 i (Not used. Programmer must spe- | 
| | cify zeros.) i 
ij 4 {| (Not used. Programmer must spe- | 
i | cify zeros.) | 
; 5 { Address of the first byte in the | 
i {| output area (see "Output" | 
| | below). | 
be ek re te ee J 
Figure 10. Contents of the pointer table 


OPERAND FORM: 


ERROR CONDITIONS: 


OUTPUT: 


MF=L 
specifies that expansion of the macro 
instruction is to consist of a parame- 
ter list only. The name of the param- 
eter list is the symbolic name speci- 
fied in the “Name“ field of this ANA- 
LYZ macro instruction. The “polst" 
and “pointer"™ operands may only be 
written as relocatable expressions. 


MF=(E, parameter list name) 
specifies that the macro instruction 
is to perform the ANALYZ functions 
using a parameter list constructed by 
another ANALYZ macro instruction. The 
“parameter list name" operand must 
correspond exactly to the name of the 
parameter list. 


MF=(E, (n)) 

performs the same function as (E, 
parameter list name). By writing 
register notation (in the range 2 
through 12), the programmer signifies 
that he will load the address of the 
parameter list into the indicated 
register before the macro instruction 
is executed. 


The following are the allow- 
able operand forms for the ANALYZ macro 
instruction. 


1. If the MF keyword operand is omitted 
or specified as L, the “polst address" 
and “pointer address" operands must be 
written as relocatable expressions. 


2. If the MF=E keyword operand is speci- 
fied, the “polst address", “pointer 
address", and “parameter list name" 
Operands can be written as relocatable 
expressions; as implied or explicit, 
indexed or nonindexed addresses; or in 
register notation. For example: 


LISTNAME ANALYZ POLST, POINTER, MF=L 
ANAYLZ POLST1,MF=(E, LISTNAME) 
Or 
LA 2,POLST1 
LA .  3,LISTNAME 
ANALYZ (2) ,MF=(E, (3)) 


If either the “polst 
address" or “pointer address" operand is 
missing at assembly time, a message is 
printed on the assembly listing indicating 
the omission, and macro generation con- 
tinues. If either parameter is missing, 
the macro instruction does not perform its 
intended function. 


The output of the ANALYZ macro 
instruction is placed in an eight-byte out- 
put area whose address is in word five of 
the pointer table. This area must begin on 
a fullword boundary. Output consists of 
the following, in the order listed: 


e Reserved (four bytes) 
e UCB address index factor (one byte) 
e Address of DCB (three bytes) 


ROUTINE EXITS: If inspection of the DCB 
list finds no attention indication, a code 
of hexadecimal 04 is placed in the return 
code register, and control is returned to 
the next sequential instruction in the app- 
lication program. If an attention is 
detected, the macro instruction determines 
the address of the DCB, resets the GCB, 
Stores output data in the output area, and 
gives control to the appropriate applica- 
tion program attention handling routine 
with the address of the output area in 
register 1 and the return address in 
register 14. The application programmer 
must save and restore registers in his 
attention handling routine. 


Note that the application program atten- 
tion handling routine, upon completion, 
does not return control to ANALYZ. Control 
may be returned from the attention handling 
routine to the next sequential instruction 
after ANALYZ by use of the RETURN macro 
instruction. 


When ANALYZ is executed, it starts ini- 
tially at the top of the pcocll list; but 
after the initial keyboard attention has 
been processed, starts at the point of pre- 
vious exit from the poll list. 


A return to the application program next 
sequential instruction is made (1) if no 
attention occurred, or (2) if the address 
of a 2260 keyboard attention routine is not 
provided in word two of the pointer table, 
or (3) if the address of an output area is 
not provided in word five of the pointer 
table. The attention is lost if no key- 
board attention routine is provided. The 
return code register contains a hexadecimal 
code to indicate the reason for this 
return, as follows: 


Contents of 
Return Code 


Register Meaning 
00 Normal 
04 No attention occurred 
08 An asynchronous error atten- 
tion occurred 
oc Poli list address or attention 


routine list address is not 
in the parameter list 

10 Output area address is not in 
the attention routine list 


Write-to-programmer messages are issued 
for the error conditions. For message 
explanations and programmer error checks, 
see OS/VS Problem Determination Aids and 


Messages and Codes for GPS and GSP. 


{* MAIN ROUTINE PROCESSING 


| 
| 
| 
| 
| POLST, POINTER | 
| ° | 
; | 
| - | 
| POLST pc F'Q' 
| DS 2F | 
[POINTER DC F°Q* | 
| DC A(KBRTN) | 
| pc 2F‘'0* | 
| Dc A(OUTAREA) | 
|OUTAREA DC 2F"0* | 
soars ca oe ee —J 
Figure 11. Graphic attention analysis rou- 

tine, coding example 

EXAMPLE: Figure 11 illustrates applicable 


coding in a typical IBM 2260 Local graphic 
job that uses the ANALYZ macro instruction. 


POLST is the symbolic address of the 
first fullword entry in a list of DCB 
addresses and UCB index factors. Note that. 
the first word in the list is set to zeros. 
POINTER is the symbolic address of the 
first entry in a five-word table that con- 
tains the entry address of the application 
program attention handling routines and the 
address of an output area (OUTAREA). 


SUGGESTIONS. FOR THE APPLICATION PROGRAMMER: 


The application programmer opens the graph- 
ic device, thereby setting up the appropri- 
ate control blocks. A suggested initiali- 
zation procedure is the execution of a 
channel program, after the device is open, 
to inform an operator at the display sta- 
tion that the graphic program is now 
executing. Polling might then be started 
immediately by the application program if 
information resulting from attentions is to 
be processed. 


During the period that an attention 
might logically be expected from a display 
station, polling should be done periodical- 
ly. The timing of this function may be 
handled either by employing the ANALYZ 
macro instruction at appropriate times dur- 
ing execution of the problem program, or by 
use of a Set Interval Timer (STIMER) system 
macro instruction which causes the Systen/ 
370 interval timer to employ the ANALYZ 
macro instruction at programmer~specified 


intervals. (See OS/VS Supervisor Services 


and Macro Instructions for the format and 


use of the STIMER macro instruction.) 
However, if the timer is used for estab- 
lishing the interval between poll cycles, 
it is not available for establishing other 
task intervals. 


Appendix C: Express Attention Handling 39° 


De ee EW ANE nen ED EN NTE COD IND OUTS GED ITD AOE END MELD GUD AES ENED SHEED ERD AUERD OND GUNNS SUES WS ETE GID GREED SEINND GS AD SERED GED GUD GENTS IS SDD aD cms 


OPEN DCB1 
STIMER REAL, POLADR, 
° DINTVL=TIME 


* MAIN ROUTINE PROCESSING 


CLOSE DCB1 
Ds OD 
| TIME DC Z*00000020! 


{POLADR ANALYZ POLST,POINTER 
{* IF NO ATTENTION, RETURN TO MAIN RTN 


fees exes SEES eeeence sD SRMEES QUIRED SENAED GUID SERED SUS GED SUNT SONU ERUEN Meentee SESE une ORD GRORS SHA Ge NS senemm onal 


Figure 12. Implementation of polling 
Note: If the application programmer 
wishes, he may wait for an attention by 
repeatedly executing the polling routine 
(that is, branching to the ANALYZ state- 
ment). It should be noted, however, that 
such a technique would defeat one of the 
primary purposes of a system having multi- 
programming capabilities. 


The coding of Figure 12 shows how the 
System/370 interval timer can be used to 
eStablish a polling interval. After the 
DCB for the device has been opened, use of 
the STIMER macro instruction provides an 
automatic transfer to the polling routine 
after a programmer-specified interval of 
real time (0.2 seconds in Figure 12). Until 
the interval has elapsed, processing con- 
tinues in the main routine. Action taken 
by the polling routine, ANALYZ, depends 
upon whether or not an attention occurred. 
Control is passed to the application pro- 
gram attention handling routine if there 
was an attention or is returned to the 
instruction following the ANALYZ macro 
instruction if an attention did not occur. 


GSERV_ -- Graphic Attention Service Macro 
instruction 


The GSERV macro instruction resets GCBs 
associated with attentions, so that an 
attention may not be handled more than 
once. This macro instruction is used by 
ANALYZ to reset the bits in the GCBs. If 
the application programmer elects to per- 
form his own attention analysis, GSERV must 
be used to reset (that is, zero) bits in 
the GCBs. The format of the GSERV macro 
instruction is: 


40 


| Name | Operation| Operand [ 


i ae as oh ve aac ae ~~~ -~--- --—-- - ------—-] 


| (symbol ] | GSERV | {list item address, | 
| [| | gcb bit] (1)} | 


lene eek Se ee a a eee 


wa 7 


list item address 


is the symbolic address of a four-byte 
field, aligned on a fullword boundary, 
in the programmer's list of DCB 
addresses and UCB index factors. This 
list is constructed at open time if 
the POLST operand is written in the 
DCB macro instruction. The four-byte 
field contains the address of the DCB 
and the UCB index factor that indi- 
cates the appropriate UCB for the | 


device. 
-—--~,-----+-+--- 
| UCB | DCB Address|list item 
| index | | address 
eee keene eee J 
bit 0 7 8 31 
gcb bit 


specifies which bit in the GCB is to 
be reset. The value of “gcb bit" must 
be 1 for the 2260. 


If register notation is used, the paran- 
eters must have been loaded into register 1 
before execution of the macro instruction. 
The format for loading the information into 
the register is as follows: 


igeb bit|list item| register 1 
; {| address | 


bit 0 7 8 31 


To define the bit to be reset, the pro- 
grammer codes the high-order byte in the 
register as foliows: 


Type of GCB Bit to 
Attention be Reset Code 
Keyboard Entry 7 Dc x‘01'° 


The address that comprises the three 
low-order bytes may be obtained from the 
poll list created by the OPEN macro 
instruction if the POLST operand was speci- 
fied in the DCB macro instruction. 


If the UCB address is invalid or if the 
device is not a graphic device, the job is 
abnormally terminated. 


After GSERV has reset the GCB bit, con- 
trol is returned to the next sequential 
instruction of the calling program. 


PROGRAMMING NOTES: ‘The graphic control 
byte is set to zero when the first DCB is 
opened for any display station. 


APPENDIX D: SUMMARY OF OPERANDS 


The Summary of Operands, shown in this appendix, contains all of 
the macro instructions and indicates the allowable ways of writing the 
operands. The summary is designed so that it can be opened with all 
the macro instructions displayed when the descriptions are being read. 
The classifications used in the summary are as follows: 


SYM 
is any symbol valid in the assembler language. 


DEC INT 
are any decimal digits up to the value indicated in the assoc- 
iated macro instruction description. If both SYM and DEC INT are 
checked, an absolute expression is also allowed. 


REGISTER 

is always coded within parentheses as follows: 

(2-12) - one of general registers 2 through 12, previously loaded 
with the right-adjusted value or address specified in 
the associated macro instruction description. The 
unused high-order bits must be set to zero. The register 
may be designated symbolically or with an absolute 
expression. 


(1) - general register 1, previously loaded as indicated above. 
The register can be designated only as (1). 


Note: Register notation may be used with E-form macro instructions only. 


RX TYPE 


any address that is valid in a RX-type instruction (e.g., LA) may 
be designated. 


A-TYPE ADCON TYPE 
any address that may be written in an A-type address constant may 
be designated. 


Note: 
e Underscoring indicates a default option; that is, if no operand 
is coded, the underscored operand is assumed. 


e Braces,{ }, indicate that one operand from a vertical or 
horizontal group must be chosen unless a default option is 
indicated. 


e The vertical stroke (|) separates alternative operands within 
a horizontal group. 


WRITTEN AS 
MACRO OPERANDS SYM DEC RX 
INSTRUCTION INT (2-12) type 


ANALYZ | polst address refer to macro description 
pointer address refer to macro description 


MF=(L written as shown 
| 
parameter list name) 


written as shown 

eee 

ATINING | gacb oddress SS xO 
MODE=/ R written as shown 


W written as shown 
(C, written as shown 

branch address)" 220 Noe eK 
CLEAR written as shown 
1 through 25 or ALL 

written as shown 
| __% parameter list address) | | Ex TE 
CLOSE PACD Odes en Se eee aes este cae te ef ed oe ee he 


ae L written as shown 
(E, 
parameter list name) 


he 2 Baek Re ee eee eee 
DAR PAOGCD GIN SSS cone et Ne es fo ds bat ne het came Nee 
me L written as shown 


i written as shown, 


DCB DSORG=GS written as shown 
MACRF= {R}|W|RC| WC] (R,W) | (RC,W)| (R, WC) | (RC, WC) } 


-DDNAMESidnone dx Cr 
TEXIST=exit list addres =f S| 
TGNCP=number of blocks | —*+d| sd 
POLST=poll list address —s| eens 


Pee I ee ee 
Ogi ee 
(LTE 


GREAD SES TES een (See (Sean (enue (OO: ae |e ORE, 
{DSM |DSMW| SMI | SMIW| DSB | DSBW } 


GCNTRL ee es 
(ERS TERSW) 


Cdeb addres —SSCSCS~C~sSSSC~‘idCSCSC‘C;*‘*”’ 
length SSSC—sSCid OO 
Varea address ——SSCS=~“~*‘“‘*~S*ésdCSCSC‘“C*‘~*r 
Ponit 
(LTE 
GSERV 


GWRITE ft IS IN ae a a ee ee 
{DSB | DSBW | EBW | EBWW | LNE | LNEW | EWL| EWLW 3} 
dcb address ee See eee IE Ee 


PMFSSSOS™S~S~™SCSRL TE 
— 


ae a 

BOS a ea cee 
aa | 
ae 


OPEN 


gach list sai (eoeinek (oui eet aewe! 


| 


L 


RT 
MF = 
c| 
gach list address) 


(*) Register notation may be used with E-form macro instructions only. 


Appendix D: 


WRITTEN AS 
MACRO OPERANDS SYM DEC 
INSTRUCTION: INT (2-12) (1) 
EP= sentry point address (canara eee eee (GRa e eneeeees eee 
10 he ae Sie eee eee es ee 
DCB=dcb address iss RS at as es 
COMAREA=communication area Bl Ls 
address | 
ATTNTY P= {(fA | S| R },2260) | SAVE| RESTORE } 


written as shown 
written as shown 


Sean eee See ee ae ae Lows ot 


Summary of Operands 


Pgacbaddress Ss—<~dTSC TCT CU 
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Indexes to systems reference manuals are 
consolidated in OS/VS Master Index, GC28- 
0602. For additional information about any 
subject listed below, refer to other publi- 
cations listed for the same subject in the 
master index. 


Where more than reference is given, the 
major reference is first. 


alphameric keyboard 1 
ANALYZ macro instruction 37-40,7 
ANALYZ pointer table 38 
area address operand 10,14 
attention 2, 21,37 
attention handling 
basic 21-29,2 
express 37-40,2 
attention handling routine, application 
program 27-28,2 
attention type 22-23 
ATTININQ macro instruction 25-27,21-23,29 
ATTNTYP 22,23 


basic attention handling 21-29,2 
bit mask for resetting GCB 40 
buffer storage 1,10-12,14-17 


cathode ray tube 1 

CcCWs (channel command words) 
CCW formats 34-36 

channel byte count 11,12 
channel command words (CCWs) 
character generator 1 
check symbol 11,12 
CLOSE macro instruction 
COMAREA 22-23,27-28,30 
completion flag in ECB 19-20 
conventions 3-4 

CRT (cathode ray tube) 1 
cursor 1,11-12,14-17 


2,10-12,15-17 


19-20,5,25 


DAR macro instruction 
data control block 
(DCB) 6-8,2,5,9-10,13-14,17,19,20,22 
data entry 1 
data event control block 

(DECB) 6,9-10,12,13,17 
data extent block (DEB) 5 
DCB (data control 

block) 6-8,2,5,9-10,13-14,17,19,20,22 
DCB macro instruction 6-8,5 
DCBD macro instruction 8 
DD statement. 5,7-9 
DDNAME 7 
DEB (data extent block) 5 
DECB (data event control 

block) 6,9-10,12,13,17 


25,21,22,29 


INDEX 


destructive cursor i1 

DSB (read full display station buffer 
Storage) 11,10,34 

DSB (write buffer storage) 14-15,13,35 

DSBW (read full display station buffer 
storage without keyboard 


restore) 11,10,35 
DSBW (write buffer storage without keyboard 
restore) 15,13,35 
DSM (read display station manual input 
message) 10-11,34 


DSMW (read display station manual input 
message without keyboard 

restore) 11,10,34 

DSORG 6,8 


EBW (erase and write display station buffer 
storage) 15,13,35 
EBWW (erase and write display station 
buffer storage without keyboard 
restore) 15,13,35 
ECB (event control block) 
E-form macro instructions 
end of message 11-12 
EP 22,23 
EP=0 23 
error handling 2 
errors, read 12-13 
errors, write 16 
ERS (erase display station buffer 
storage) 17,36 
ERSW (erase display station buffer storage 
without keyboard restore) 17-18, 36 
event control block (ECB) 6,12,16,18-20 
EWL (erase and write display station line 
address) 16,14,36 
EWLW (erase and write display station line 
address without keyboard 
restore) 16,14,36 
EXLST 7 
Express attention handling 37-40,2 


6 212,16,18-20 
4,6,10,14,17 


format illustration conventions 3-4 


GACB (graphic attention control 
block) 21-29 

gacb list address operand 24,25 

GCB 37-40 

gcb bit operand 40 

GCNTRL macro instruction 17-18,5 

GNCP 7-9 | 

graphic attention control block 
(GACB) 21-29 

graphic attention service routine 

GREAD maécro instruction 9-13,5 

GSERV macro instruction 40 

GTYPE 7 

GWRITE macro instruction 10-16,5 


Index 43 


IBM 1053 printer 5,10,14,17 
IBM 1053 printer adapter unit 1 
IBM 2260 local 1 
IBM 2260 remote i 
IBM 2701 data adapter unit 1 
IBM 2848 display control i 
input/output block (IOB) 6-9 
input/output control 5-20,2 
input/output control routine 6 
input/output macro instructions 5 

CLOSE 19-20,5,25 

DCB 6-8,5 

GCNTRL 17-18,5 

GREAD 9-13,5 

GWRITE 10-16,5 

OPEN 8-9,5 
IOB (input/output block) 6-9 
IX 23 


keyboard 1,21,37 


length operand 10,14 

L-form macro instructions 4,6,10,14,17 
line addressing 1,15-16 

LNE (write display station line 

address) 15,13,36 

LNEW (write display station line address 
without keyboard restore) 15,14,36 
linkage conventions 4 

list item address operand 40 


MACRF codes 6-7 
macro-form operand 

(MF) 4,6,9,10,14,17,19, 22, 24-26, 38 
MODE 26 


new line symbol i1 
nondestructive cursor 1,11 
numeric keyboard 1 


OPEN macro instruction 8-9,5,20 
output of ANALYZ 38-39 


parameter list address operand 26 
pointer address operand 38 

pointer table for attention handling 38 
polling 37-40 

polling interval 39-40 

polling techniques 37,39-40 


uy 


POLST 7-8,38-39 

polst address operand 38 

post the ECB 19-20, 28 

POST macro instruction 28 

printer adapter unit 1 

priority among attention routines 24,21-22 
problem determination 2,9,13,16,18 

PRTY 24 


read error 12-13 

register notation 3,13,16,18 
reset GCB 40 

return codes 


ANALYZ 39 
GCNTRL 18 
GREAD 13 

GWRITE 16 


RETURN macro instruction 28 


SAEC macro instruction 21-24,29 
Sample program 30-33 

SMI (read display station short manual 
input message) 11,10,34 

SMIW (read display station short manual 
input message without keyboard 
restore) 11,10,34 

SPAR macro instruction 24-25, 21, 22,29 
start symbol 11 

STIMER macro instruction 39-40 

stop sequence 11 

synchronous error 2 

system generation 2 


terminology 4 
TYPE 23 
type operand 10,13-14,17 


UCB (unit control block) 5-6 
UCB index 5-6 

UNIT 26 

unit control block (UCB) 5-6 
unit operand 6,10,14,17 


VS2 2-3,20,28-29 


wait for an attention 28 

WAIT macro instruction 18,5,28 
wait state 25-26 

write error 16 
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will be sent to the author’s department for appropriate action. Using this 

form to request system assistance or additional publications will delay response, 
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How did you use this publication? 
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